@docyrus/cli 0.1.0

package/dist/cli.js

@@ -0,0 +1,2925 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { RestApiClient, AuthenticationError as AuthenticationError$1 } from '@docyrus/api-client';
+import { createServer } from 'http';
+import { URL, fileURLToPath } from 'url';
+import { randomBytes, createDecipheriv, createCipheriv, scryptSync, createHash } from 'crypto';
+import open from 'open';
+import { existsSync, readFileSync, mkdirSync, writeFileSync, unlinkSync, constants as constants$1 } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { homedir, arch, release, platform, hostname, userInfo } from 'os';
+import Conf from 'conf';
+import chalk4 from 'chalk';
+import ora from 'ora';
+import { select, input, password } from '@inquirer/prompts';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { access, constants, writeFile, readFile, mkdir, cp, rm, readdir } from 'fs/promises';
+import { downloadTemplate } from 'giget';
+import { generateFromOpenAPI } from '@docyrus/tanstack-db-generator';
+
+// src/config/constants.ts
+var DOCYRUS_API_URL = "https://alpha-api.docyrus.com";
+var OAUTH_CLIENT_ID = "90565525-8283-4881-82a9-8613eb82ae27";
+var OAUTH_SCOPES = "offline_access Read.All Users.Read Users.Read.All DS.Read.All".split(" ");
+var OAUTH_CALLBACK_PORT_MIN = 9876;
+var OAUTH_CALLBACK_PORT_MAX = 9899;
+var OAUTH_REDIRECT_URI = (port) => `http://localhost:${port}/callback`;
+var OAUTH_TIMEOUT_MS = 5 * 60 * 1e3;
+var KEYCHAIN_SERVICE = "docyrus-cli";
+var CONFIG_DIR = ".docyrus";
+var CREDENTIALS_FILE = "credentials.enc";
+var TOKEN_KEYS = {
+  ACCESS_TOKEN: "accessToken",
+  REFRESH_TOKEN: "refreshToken",
+  USER_EMAIL: "userEmail",
+  GITHUB_TOKEN: "githubToken"
+  // For private template access - persists after logout
+};
+var CLI_NAME = "docyrus";
+var CLI_VERSION = "0.0.1";
+var NPM_PACKAGE_NAME = "docyrus";
+
+// src/utils/errors.ts
+var CliError = class extends Error {
+  exitCode;
+  suggestion;
+  constructor(message, exitCode = 1, suggestion) {
+    super(message);
+    this.name = "CliError";
+    this.exitCode = exitCode;
+    this.suggestion = suggestion;
+  }
+};
+var AuthenticationError = class extends CliError {
+  constructor(message = "Authentication failed", suggestion) {
+    super(message, 1, suggestion || "Please check your credentials and try again.");
+    this.name = "AuthenticationError";
+  }
+};
+var NotLoggedInError = class extends CliError {
+  constructor(message = "You are not logged in.") {
+    super(message, 1, "Run `docyrus login` to authenticate.");
+    this.name = "NotLoggedInError";
+  }
+};
+var NetworkError = class extends CliError {
+  constructor(message = "Network request failed", suggestion) {
+    super(message, 1, suggestion || "Please check your internet connection and try again.");
+    this.name = "NetworkError";
+  }
+};
+var TimeoutError = class extends CliError {
+  constructor(message = "Operation timed out") {
+    super(message, 1, "Please try again.");
+    this.name = "TimeoutError";
+  }
+};
+var OAuthError = class extends CliError {
+  constructor(message, suggestion) {
+    super(message, 1, suggestion || "Please try again or use email/password login.");
+    this.name = "OAuthError";
+  }
+};
+var TemplateError = class extends CliError {
+  constructor(message) {
+    super(message, 1, "Check your internet connection and try again.");
+    this.name = "TemplateError";
+  }
+};
+var ProjectExistsError = class extends CliError {
+  constructor(projectName) {
+    super(
+      `Directory "${projectName}" already exists.`,
+      1,
+      "Choose a different project name or delete the existing directory."
+    );
+    this.name = "ProjectExistsError";
+  }
+};
+var ConflictingFlagsError = class extends CliError {
+  constructor(flag1, flag2) {
+    super(
+      `Cannot use ${flag1} and ${flag2} together.`,
+      1,
+      "Please use only one option from each group."
+    );
+    this.name = "ConflictingFlagsError";
+  }
+};
+
+// src/auth/credential-auth.ts
+function getApiClient() {
+  return new RestApiClient({ baseURL: DOCYRUS_API_URL });
+}
+async function loginWithCredentials(credentials) {
+  const client = getApiClient();
+  try {
+    const response = await client.post("/v1/auth/token", {
+      email: credentials.email,
+      password: credentials.password
+    });
+    const tokens = {
+      accessToken: response.data.access_token,
+      refreshToken: response.data.refresh_token,
+      expiresIn: response.data.expires_in
+    };
+    if (tokens.expiresIn) {
+      tokens.expiresAt = Date.now() + tokens.expiresIn * 1e3;
+    }
+    return {
+      tokens,
+      user: response.data.user
+    };
+  } catch (error) {
+    if (error instanceof AuthenticationError$1) {
+      throw new AuthenticationError("Invalid email or password.");
+    }
+    if (error instanceof Error && error.message.includes("fetch")) {
+      throw new NetworkError();
+    }
+    throw error;
+  }
+}
+async function getUserInfo(accessToken) {
+  const client = new RestApiClient({ baseURL: DOCYRUS_API_URL });
+  await client.setAccessToken(accessToken);
+  try {
+    const response = await client.get("/v1/users/me");
+    return response.data;
+  } catch (error) {
+    if (error instanceof AuthenticationError$1) {
+      throw new AuthenticationError("Session expired. Please log in again.");
+    }
+    throw error;
+  }
+}
+async function refreshAccessToken(refreshToken) {
+  const tokenUrl = `${DOCYRUS_API_URL}/v1/oauth2/token`;
+  try {
+    const response = await fetch(tokenUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded"
+      },
+      body: new URLSearchParams({
+        grant_type: "refresh_token",
+        client_id: OAUTH_CLIENT_ID,
+        refresh_token: refreshToken
+      }).toString()
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}));
+      throw new AuthenticationError(
+        errorData.error_description || "Failed to refresh token"
+      );
+    }
+    const data = await response.json();
+    const tokens = {
+      accessToken: data.access_token,
+      refreshToken: data.refresh_token || refreshToken,
+      expiresIn: data.expires_in,
+      tokenType: data.token_type
+    };
+    if (tokens.expiresIn) {
+      tokens.expiresAt = Date.now() + tokens.expiresIn * 1e3;
+    }
+    return tokens;
+  } catch (error) {
+    if (error instanceof AuthenticationError) {
+      throw error;
+    }
+    if (error instanceof Error && error.message.includes("fetch")) {
+      throw new NetworkError();
+    }
+    throw new AuthenticationError("Session expired. Please log in again.");
+  }
+}
+var SUCCESS_HTML = `
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Authentication Successful - Docyrus CLI</title>
+  <style>
+    * { box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      margin: 0;
+      background: linear-gradient(to bottom right, #f8fafc, #f1f5f9);
+    }
+    .container {
+      width: 100%;
+      max-width: 400px;
+      padding: 32px;
+      background: white;
+      border-radius: 16px;
+      box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.15);
+      text-align: center;
+    }
+    .logo {
+      margin-bottom: 24px;
+    }
+    .logo svg {
+      height: 40px;
+      width: auto;
+    }
+    h1 {
+      margin: 0 0 8px;
+      font-size: 20px;
+      font-weight: 600;
+      color: #1e293b;
+    }
+    p {
+      margin: 0;
+      color: #64748b;
+      font-size: 14px;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="logo">
+      <svg viewBox="0 0 1325.62 253.55" xmlns="http://www.w3.org/2000/svg">
+        <path fill="#dc2626" d="M169.13,133.22l-.07.06v29.48c0,7.81-6.35,14.17-14.16,14.17h-29.48c-2.54,0-4.9-.68-6.96-1.85l-33.13,33.14c2.16,3.21,3.43,7.09,3.43,11.21,0,5.53-2.22,10.54-5.84,14.17-3.62,3.62-8.64,5.84-14.17,5.84s-10.55-2.22-14.17-5.84c-3.62-3.63-5.84-8.64-5.84-14.17,0-11.06,8.96-20.08,20.07-20.08,4.22,0,8.09,1.29,11.3,3.48l33.11-33.11c-1.22-2.07-1.91-4.46-1.91-7.02v-29.48c0-3.24,1.11-6.26,2.97-8.65l-27.31-37.16H19.96V15.5h71.85v65.82l28.44,38.71c1.62-.65,3.39-.98,5.23-.98h29.48c7.81,0,14.17,6.36,14.17,14.17Z"/>
+        <path fill="#1c1c1c" d="M241.24,60.57h48.58c12.19,0,23,2.42,32.44,7.25,9.44,4.83,16.77,11.61,21.98,20.34,5.21,8.73,7.82,18.75,7.82,30.05s-2.61,21.32-7.82,30.05c-5.22,8.73-12.54,15.51-21.98,20.34-9.44,4.83-20.25,7.25-32.44,7.25h-48.58V60.57ZM288.83,161.51c9.33,0,17.54-1.81,24.62-5.43,7.08-3.62,12.54-8.7,16.38-15.23,3.84-6.53,5.76-14.08,5.76-22.64s-1.92-16.11-5.76-22.64c-3.84-6.53-9.3-11.61-16.38-15.23-7.08-3.62-15.29-5.43-24.62-5.43h-31.12v86.61h31.12Z"/>
+        <path fill="#1c1c1c" d="M430.77,169.5c-9.33-5.1-16.66-12.16-21.98-21.16-5.33-9-7.99-19.04-7.99-30.13s2.66-21.13,7.99-30.13c5.32-9,12.65-16.06,21.98-21.16,9.33-5.1,19.81-7.66,31.45-7.66s21.96,2.55,31.29,7.66c9.33,5.1,16.63,12.13,21.9,21.08,5.27,8.95,7.9,19.02,7.9,30.22s-2.63,21.27-7.9,30.22c-5.27,8.95-12.57,15.97-21.9,21.08-9.33,5.1-19.76,7.66-31.29,7.66s-22.12-2.55-31.45-7.66ZM485.03,156.74c6.75-3.84,12.07-9.14,15.97-15.89,3.9-6.75,5.85-14.3,5.85-22.64s-1.95-15.89-5.85-22.64c-3.9-6.75-9.22-12.05-15.97-15.89-6.75-3.84-14.35-5.76-22.81-5.76s-16.11,1.92-22.97,5.76c-6.86,3.84-12.24,9.14-16.14,15.89-3.9,6.75-5.85,14.3-5.85,22.64s1.95,15.89,5.85,22.64c3.9,6.75,9.28,12.05,16.14,15.89,6.86,3.84,14.52,5.76,22.97,5.76s16.06-1.92,22.81-5.76Z"/>
+        <path fill="#1c1c1c" d="M601.78,169.5c-9.28-5.1-16.55-12.13-21.82-21.08-5.27-8.95-7.9-19.02-7.9-30.22s2.63-21.27,7.9-30.22c5.27-8.95,12.57-15.97,21.9-21.08,9.33-5.1,19.76-7.66,31.29-7.66,9,0,17.23,1.51,24.7,4.53,7.46,3.02,13.83,7.49,19.1,13.42l-10.7,10.37c-8.67-9.11-19.49-13.67-32.44-13.67-8.56,0-16.3,1.92-23.22,5.76-6.92,3.84-12.32,9.14-16.22,15.89-3.9,6.75-5.85,14.3-5.85,22.64s1.95,15.89,5.85,22.64c3.9,6.75,9.3,12.05,16.22,15.89,6.92,3.84,14.66,5.76,23.22,5.76,12.84,0,23.66-4.61,32.44-13.83l10.7,10.37c-5.27,5.93-11.67,10.43-19.18,13.5-7.52,3.07-15.78,4.61-24.78,4.61-11.53,0-21.93-2.55-31.2-7.66Z"/>
+        <path fill="#1c1c1c" d="M775.59,135.99v39.85h-16.3v-40.18l-45.78-75.09h17.62l36.89,60.76,37.05-60.76h16.3l-45.78,75.42Z"/>
+        <path fill="#1c1c1c" d="M946.01,175.84l-24.87-35.4c-3.07.22-5.49.33-7.25.33h-28.49v35.07h-16.47V60.57h44.95c14.93,0,26.68,3.57,35.24,10.7,8.56,7.14,12.84,16.96,12.84,29.48,0,8.89-2.2,16.47-6.59,22.72-4.39,6.26-10.65,10.81-18.77,13.67l27.33,38.7h-17.95ZM937.29,120.02c5.49-4.5,8.23-10.92,8.23-19.27s-2.75-14.74-8.23-19.18c-5.49-4.45-13.45-6.67-23.88-6.67h-27.99v51.87h27.99c10.43,0,18.39-2.25,23.88-6.75Z"/>
+        <path fill="#1c1c1c" d="M1033.45,163.98c-8.56-8.78-12.84-21.41-12.84-37.87V60.57h16.47v64.88c0,24.7,10.81,37.05,32.44,37.05,10.54,0,18.61-3.05,24.21-9.14s8.4-15.4,8.4-27.91V60.57h15.97v65.54c0,16.58-4.28,29.23-12.84,37.96-8.56,8.73-20.53,13.09-35.9,13.09s-27.33-4.39-35.9-13.17Z"/>
+        <path fill="#1c1c1c" d="M1193.26,173.12c-8.07-2.69-14.41-6.18-19.02-10.46l6.09-12.84c4.39,3.95,10.02,7.16,16.88,9.63,6.86,2.47,13.91,3.7,21.16,3.7,9.55,0,16.69-1.62,21.41-4.86,4.72-3.24,7.08-7.55,7.08-12.93,0-3.95-1.29-7.16-3.87-9.63-2.58-2.47-5.76-4.36-9.55-5.68s-9.14-2.8-16.05-4.45c-8.67-2.08-15.67-4.17-21-6.26-5.33-2.08-9.88-5.29-13.67-9.63-3.79-4.34-5.68-10.18-5.68-17.54,0-6.15,1.62-11.69,4.86-16.63,3.24-4.94,8.15-8.89,14.74-11.86,6.59-2.96,14.76-4.45,24.54-4.45,6.81,0,13.5.88,20.09,2.63,6.59,1.76,12.24,4.28,16.96,7.57l-5.43,13.17c-4.83-3.07-9.99-5.41-15.48-7-5.49-1.59-10.87-2.39-16.14-2.39-9.33,0-16.33,1.7-21,5.1-4.67,3.4-7,7.8-7,13.17,0,3.95,1.32,7.16,3.95,9.63,2.63,2.47,5.9,4.39,9.8,5.76,3.9,1.37,9.19,2.83,15.89,4.36,8.67,2.09,15.64,4.17,20.91,6.26,5.27,2.09,9.8,5.27,13.58,9.55,3.79,4.28,5.68,10.04,5.68,17.29,0,6.04-1.65,11.55-4.94,16.55-3.29,5-8.29,8.95-14.99,11.86-6.7,2.91-14.93,4.36-24.7,4.36-8.67,0-17.04-1.34-25.11-4.03Z"/>
+      </svg>
+    </div>
+    <h1>Authentication Successful</h1>
+    <p>You can close this tab and return to the CLI.</p>
+  </div>
+</body>
+</html>
+`;
+var ERROR_HTML = (message) => `
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Authentication Failed - Docyrus CLI</title>
+  <style>
+    * { box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      margin: 0;
+      background: linear-gradient(to bottom right, #f8fafc, #f1f5f9);
+    }
+    .container {
+      width: 100%;
+      max-width: 400px;
+      padding: 32px;
+      background: white;
+      border-radius: 16px;
+      box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.15);
+      text-align: center;
+    }
+    .logo {
+      margin-bottom: 24px;
+    }
+    .logo svg {
+      height: 40px;
+      width: auto;
+    }
+    h1 {
+      margin: 0 0 8px;
+      font-size: 20px;
+      font-weight: 600;
+      color: #1e293b;
+    }
+    p {
+      margin: 0;
+      color: #64748b;
+      font-size: 14px;
+    }
+    .error-message {
+      margin-top: 16px;
+      padding: 12px;
+      background: #fef2f2;
+      border-radius: 8px;
+      color: #dc2626;
+      font-size: 13px;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="logo">
+      <svg viewBox="0 0 1325.62 253.55" xmlns="http://www.w3.org/2000/svg">
+        <path fill="#dc2626" d="M169.13,133.22l-.07.06v29.48c0,7.81-6.35,14.17-14.16,14.17h-29.48c-2.54,0-4.9-.68-6.96-1.85l-33.13,33.14c2.16,3.21,3.43,7.09,3.43,11.21,0,5.53-2.22,10.54-5.84,14.17-3.62,3.62-8.64,5.84-14.17,5.84s-10.55-2.22-14.17-5.84c-3.62-3.63-5.84-8.64-5.84-14.17,0-11.06,8.96-20.08,20.07-20.08,4.22,0,8.09,1.29,11.3,3.48l33.11-33.11c-1.22-2.07-1.91-4.46-1.91-7.02v-29.48c0-3.24,1.11-6.26,2.97-8.65l-27.31-37.16H19.96V15.5h71.85v65.82l28.44,38.71c1.62-.65,3.39-.98,5.23-.98h29.48c7.81,0,14.17,6.36,14.17,14.17Z"/>
+        <path fill="#1c1c1c" d="M241.24,60.57h48.58c12.19,0,23,2.42,32.44,7.25,9.44,4.83,16.77,11.61,21.98,20.34,5.21,8.73,7.82,18.75,7.82,30.05s-2.61,21.32-7.82,30.05c-5.22,8.73-12.54,15.51-21.98,20.34-9.44,4.83-20.25,7.25-32.44,7.25h-48.58V60.57ZM288.83,161.51c9.33,0,17.54-1.81,24.62-5.43,7.08-3.62,12.54-8.7,16.38-15.23,3.84-6.53,5.76-14.08,5.76-22.64s-1.92-16.11-5.76-22.64c-3.84-6.53-9.3-11.61-16.38-15.23-7.08-3.62-15.29-5.43-24.62-5.43h-31.12v86.61h31.12Z"/>
+        <path fill="#1c1c1c" d="M430.77,169.5c-9.33-5.1-16.66-12.16-21.98-21.16-5.33-9-7.99-19.04-7.99-30.13s2.66-21.13,7.99-30.13c5.32-9,12.65-16.06,21.98-21.16,9.33-5.1,19.81-7.66,31.45-7.66s21.96,2.55,31.29,7.66c9.33,5.1,16.63,12.13,21.9,21.08,5.27,8.95,7.9,19.02,7.9,30.22s-2.63,21.27-7.9,30.22c-5.27,8.95-12.57,15.97-21.9,21.08-9.33,5.1-19.76,7.66-31.29,7.66s-22.12-2.55-31.45-7.66ZM485.03,156.74c6.75-3.84,12.07-9.14,15.97-15.89,3.9-6.75,5.85-14.3,5.85-22.64s-1.95-15.89-5.85-22.64c-3.9-6.75-9.22-12.05-15.97-15.89-6.75-3.84-14.35-5.76-22.81-5.76s-16.11,1.92-22.97,5.76c-6.86,3.84-12.24,9.14-16.14,15.89-3.9,6.75-5.85,14.3-5.85,22.64s1.95,15.89,5.85,22.64c3.9,6.75,9.28,12.05,16.14,15.89,6.86,3.84,14.52,5.76,22.97,5.76s16.06-1.92,22.81-5.76Z"/>
+        <path fill="#1c1c1c" d="M601.78,169.5c-9.28-5.1-16.55-12.13-21.82-21.08-5.27-8.95-7.9-19.02-7.9-30.22s2.63-21.27,7.9-30.22c5.27-8.95,12.57-15.97,21.9-21.08,9.33-5.1,19.76-7.66,31.29-7.66,9,0,17.23,1.51,24.7,4.53,7.46,3.02,13.83,7.49,19.1,13.42l-10.7,10.37c-8.67-9.11-19.49-13.67-32.44-13.67-8.56,0-16.3,1.92-23.22,5.76-6.92,3.84-12.32,9.14-16.22,15.89-3.9,6.75-5.85,14.3-5.85,22.64s1.95,15.89,5.85,22.64c3.9,6.75,9.3,12.05,16.22,15.89,6.92,3.84,14.66,5.76,23.22,5.76,12.84,0,23.66-4.61,32.44-13.83l10.7,10.37c-5.27,5.93-11.67,10.43-19.18,13.5-7.52,3.07-15.78,4.61-24.78,4.61-11.53,0-21.93-2.55-31.2-7.66Z"/>
+        <path fill="#1c1c1c" d="M775.59,135.99v39.85h-16.3v-40.18l-45.78-75.09h17.62l36.89,60.76,37.05-60.76h16.3l-45.78,75.42Z"/>
+        <path fill="#1c1c1c" d="M946.01,175.84l-24.87-35.4c-3.07.22-5.49.33-7.25.33h-28.49v35.07h-16.47V60.57h44.95c14.93,0,26.68,3.57,35.24,10.7,8.56,7.14,12.84,16.96,12.84,29.48,0,8.89-2.2,16.47-6.59,22.72-4.39,6.26-10.65,10.81-18.77,13.67l27.33,38.7h-17.95ZM937.29,120.02c5.49-4.5,8.23-10.92,8.23-19.27s-2.75-14.74-8.23-19.18c-5.49-4.45-13.45-6.67-23.88-6.67h-27.99v51.87h27.99c10.43,0,18.39-2.25,23.88-6.75Z"/>
+        <path fill="#1c1c1c" d="M1033.45,163.98c-8.56-8.78-12.84-21.41-12.84-37.87V60.57h16.47v64.88c0,24.7,10.81,37.05,32.44,37.05,10.54,0,18.61-3.05,24.21-9.14s8.4-15.4,8.4-27.91V60.57h15.97v65.54c0,16.58-4.28,29.23-12.84,37.96-8.56,8.73-20.53,13.09-35.9,13.09s-27.33-4.39-35.9-13.17Z"/>
+        <path fill="#1c1c1c" d="M1193.26,173.12c-8.07-2.69-14.41-6.18-19.02-10.46l6.09-12.84c4.39,3.95,10.02,7.16,16.88,9.63,6.86,2.47,13.91,3.7,21.16,3.7,9.55,0,16.69-1.62,21.41-4.86,4.72-3.24,7.08-7.55,7.08-12.93,0-3.95-1.29-7.16-3.87-9.63-2.58-2.47-5.76-4.36-9.55-5.68s-9.14-2.8-16.05-4.45c-8.67-2.08-15.67-4.17-21-6.26-5.33-2.08-9.88-5.29-13.67-9.63-3.79-4.34-5.68-10.18-5.68-17.54,0-6.15,1.62-11.69,4.86-16.63,3.24-4.94,8.15-8.89,14.74-11.86,6.59-2.96,14.76-4.45,24.54-4.45,6.81,0,13.5.88,20.09,2.63,6.59,1.76,12.24,4.28,16.96,7.57l-5.43,13.17c-4.83-3.07-9.99-5.41-15.48-7-5.49-1.59-10.87-2.39-16.14-2.39-9.33,0-16.33,1.7-21,5.1-4.67,3.4-7,7.8-7,13.17,0,3.95,1.32,7.16,3.95,9.63,2.63,2.47,5.9,4.39,9.8,5.76,3.9,1.37,9.19,2.83,15.89,4.36,8.67,2.09,15.64,4.17,20.91,6.26,5.27,2.09,9.8,5.27,13.58,9.55,3.79,4.28,5.68,10.04,5.68,17.29,0,6.04-1.65,11.55-4.94,16.55-3.29,5-8.29,8.95-14.99,11.86-6.7,2.91-14.93,4.36-24.7,4.36-8.67,0-17.04-1.34-25.11-4.03Z"/>
+      </svg>
+    </div>
+    <h1>Authentication Failed</h1>
+    <p>Something went wrong during authentication.</p>
+    <div class="error-message">${message}</div>
+  </div>
+</body>
+</html>
+`;
+function generateState() {
+  return randomBytes(32).toString("hex");
+}
+function generateCodeVerifier() {
+  return randomBytes(32).toString("base64url");
+}
+async function generateCodeChallenge(verifier) {
+  const encoder = new TextEncoder();
+  const data = encoder.encode(verifier);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  return Buffer.from(hashBuffer).toString("base64url");
+}
+async function findAvailablePort() {
+  return new Promise((resolve3, reject) => {
+    const tryPort = (port) => {
+      if (port > OAUTH_CALLBACK_PORT_MAX) {
+        reject(new OAuthError("Could not find an available port for OAuth callback."));
+        return;
+      }
+      const server = createServer();
+      server.listen(port, "127.0.0.1");
+      server.once("listening", () => {
+        server.close(() => resolve3(port));
+      });
+      server.once("error", () => {
+        tryPort(port + 1);
+      });
+    };
+    tryPort(OAUTH_CALLBACK_PORT_MIN);
+  });
+}
+async function startCallbackServer(expectedState) {
+  const port = await findAvailablePort();
+  let resolveResult;
+  let rejectResult;
+  const resultPromise = new Promise((resolve3, reject) => {
+    resolveResult = resolve3;
+    rejectResult = reject;
+  });
+  const timeoutId = setTimeout(() => {
+    rejectResult(new TimeoutError("OAuth authentication timed out."));
+  }, OAUTH_TIMEOUT_MS);
+  const server = createServer((req, res) => {
+    const url = new URL(req.url || "/", `http://127.0.0.1:${port}`);
+    if (url.pathname === "/callback") {
+      const code = url.searchParams.get("code");
+      const state2 = url.searchParams.get("state");
+      const error = url.searchParams.get("error");
+      const errorDescription = url.searchParams.get("error_description");
+      if (error) {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end(ERROR_HTML(errorDescription || error));
+        rejectResult(new OAuthError(errorDescription || error));
+        return;
+      }
+      if (!code || !state2) {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end(ERROR_HTML("Missing authorization code or state."));
+        rejectResult(new OAuthError("Missing authorization code or state."));
+        return;
+      }
+      if (state2 !== expectedState) {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end(ERROR_HTML("Invalid state parameter. Possible CSRF attack."));
+        rejectResult(new OAuthError("Invalid state parameter."));
+        return;
+      }
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end(SUCCESS_HTML);
+      resolveResult({ code, state: state2 });
+    } else {
+      res.writeHead(404);
+      res.end("Not Found");
+    }
+  });
+  server.listen(port, "127.0.0.1");
+  const cleanup = () => {
+    clearTimeout(timeoutId);
+    server.close();
+  };
+  return {
+    server,
+    port,
+    resultPromise,
+    cleanup
+  };
+}
+async function openBrowser(url) {
+  await open(url);
+}
+
+// src/auth/oauth-auth.ts
+function getOAuthConfig(port) {
+  return {
+    authorizationUrl: `${DOCYRUS_API_URL}/v1/oauth2/authorize`,
+    tokenUrl: `${DOCYRUS_API_URL}/v1/oauth2/token`,
+    clientId: OAUTH_CLIENT_ID,
+    redirectUri: OAUTH_REDIRECT_URI(port),
+    scopes: OAUTH_SCOPES
+  };
+}
+function buildAuthorizationUrl(config, state2, codeChallenge) {
+  const params = new URLSearchParams({
+    response_type: "code",
+    client_id: config.clientId,
+    redirect_uri: config.redirectUri,
+    scope: config.scopes.join(" "),
+    state: state2,
+    code_challenge: codeChallenge,
+    code_challenge_method: "S256"
+  });
+  return `${config.authorizationUrl}?${params.toString()}`;
+}
+async function exchangeCodeForTokens(config, code, codeVerifier) {
+  const response = await fetch(config.tokenUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/x-www-form-urlencoded"
+    },
+    body: new URLSearchParams({
+      grant_type: "authorization_code",
+      client_id: config.clientId,
+      code,
+      redirect_uri: config.redirectUri,
+      code_verifier: codeVerifier
+    }).toString()
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new OAuthError(`Failed to exchange authorization code: ${errorText}`);
+  }
+  const data = await response.json();
+  const tokens = {
+    accessToken: data.access_token,
+    refreshToken: data.refresh_token,
+    expiresIn: data.expires_in,
+    tokenType: data.token_type
+  };
+  if (tokens.expiresIn) {
+    tokens.expiresAt = Date.now() + tokens.expiresIn * 1e3;
+  }
+  return tokens;
+}
+async function getUserInfoFromToken(accessToken) {
+  const client = new RestApiClient({ baseURL: DOCYRUS_API_URL });
+  await client.setAccessToken(accessToken);
+  try {
+    return await client.get("/v1/users/me");
+  } catch {
+    return void 0;
+  }
+}
+async function loginWithOAuth(options = {}) {
+  const state2 = generateState();
+  const codeVerifier = generateCodeVerifier();
+  const codeChallenge = await generateCodeChallenge(codeVerifier);
+  const { port, resultPromise, cleanup } = await startCallbackServer(state2);
+  const config = getOAuthConfig(port);
+  const authUrl = buildAuthorizationUrl(config, state2, codeChallenge);
+  try {
+    options.onOpeningBrowser?.();
+    await openBrowser(authUrl);
+    options.onWaitingForAuth?.(authUrl);
+    const { code } = await resultPromise;
+    const tokens = await exchangeCodeForTokens(config, code, codeVerifier);
+    const user = await getUserInfoFromToken(tokens.accessToken);
+    return { tokens, user };
+  } finally {
+    cleanup();
+  }
+}
+function getHomeDir() {
+  return homedir();
+}
+function getConfigDir() {
+  return join(getHomeDir(), CONFIG_DIR);
+}
+var ALGORITHM = "aes-256-gcm";
+var KEY_LENGTH = 32;
+var IV_LENGTH = 16;
+var AUTH_TAG_LENGTH = 16;
+var SALT_LENGTH = 32;
+function getMachineId() {
+  const parts = [
+    hostname(),
+    userInfo().username,
+    process.platform,
+    process.arch
+  ];
+  return createHash("sha256").update(parts.join("-")).digest("hex");
+}
+function deriveKey(salt) {
+  const machineId = getMachineId();
+  return scryptSync(machineId, salt, KEY_LENGTH);
+}
+function encrypt(data) {
+  const salt = randomBytes(SALT_LENGTH);
+  const key = deriveKey(salt);
+  const iv = randomBytes(IV_LENGTH);
+  const cipher = createCipheriv(ALGORITHM, key, iv, { authTagLength: AUTH_TAG_LENGTH });
+  const encrypted = Buffer.concat([cipher.update(data, "utf8"), cipher.final()]);
+  const authTag = cipher.getAuthTag();
+  return [
+    salt.toString("base64"),
+    iv.toString("base64"),
+    authTag.toString("base64"),
+    encrypted.toString("base64")
+  ].join(":");
+}
+function decrypt(encryptedData) {
+  const parts = encryptedData.split(":");
+  if (parts.length !== 4) {
+    throw new Error("Invalid encrypted data format");
+  }
+  const [
+    saltB64,
+    ivB64,
+    authTagB64,
+    dataB64
+  ] = parts;
+  const salt = Buffer.from(saltB64, "base64");
+  const iv = Buffer.from(ivB64, "base64");
+  const authTag = Buffer.from(authTagB64, "base64");
+  const encrypted = Buffer.from(dataB64, "base64");
+  const key = deriveKey(salt);
+  const decipher = createDecipheriv(ALGORITHM, key, iv, { authTagLength: AUTH_TAG_LENGTH });
+  decipher.setAuthTag(authTag);
+  const decrypted = Buffer.concat([decipher.update(encrypted), decipher.final()]);
+  return decrypted.toString("utf8");
+}
+
+// src/storage/file-storage.ts
+var FileStorage = class {
+  filePath;
+  constructor() {
+    const configDir = getConfigDir();
+    this.filePath = join(configDir, CREDENTIALS_FILE);
+  }
+  ensureConfigDir() {
+    const configDir = getConfigDir();
+    if (!existsSync(configDir)) {
+      mkdirSync(configDir, { recursive: true, mode: 448 });
+    }
+  }
+  readData() {
+    if (!existsSync(this.filePath)) {
+      return {};
+    }
+    try {
+      const encrypted = readFileSync(this.filePath, "utf8");
+      const decrypted = decrypt(encrypted);
+      return JSON.parse(decrypted);
+    } catch {
+      return {};
+    }
+  }
+  writeData(data) {
+    this.ensureConfigDir();
+    const json = JSON.stringify(data);
+    const encrypted = encrypt(json);
+    writeFileSync(this.filePath, encrypted, { mode: 384 });
+  }
+  async get(key) {
+    const data = this.readData();
+    return data[key] ?? null;
+  }
+  async set(key, value) {
+    const data = this.readData();
+    data[key] = value;
+    this.writeData(data);
+  }
+  async delete(key) {
+    const data = this.readData();
+    delete data[key];
+    if (Object.keys(data).length === 0) {
+      this.clear();
+    } else {
+      this.writeData(data);
+    }
+  }
+  async clear() {
+    if (existsSync(this.filePath)) {
+      unlinkSync(this.filePath);
+    }
+  }
+  async has(key) {
+    const data = this.readData();
+    return key in data;
+  }
+};
+
+// src/storage/keychain-storage.ts
+var keytar = null;
+async function getKeytar() {
+  if (keytar !== null) {
+    return keytar;
+  }
+  try {
+    keytar = await import('keytar');
+    return keytar;
+  } catch {
+    keytar = null;
+    return null;
+  }
+}
+var KeychainStorage = class {
+  service;
+  constructor(service = KEYCHAIN_SERVICE) {
+    this.service = service;
+  }
+  async isAvailable() {
+    const kt = await getKeytar();
+    if (!kt) return false;
+    try {
+      await kt.findCredentials(this.service);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async get(key) {
+    const kt = await getKeytar();
+    if (!kt) return null;
+    try {
+      return await kt.getPassword(this.service, key);
+    } catch {
+      return null;
+    }
+  }
+  async set(key, value) {
+    const kt = await getKeytar();
+    if (!kt) return false;
+    try {
+      await kt.setPassword(this.service, key, value);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async delete(key) {
+    const kt = await getKeytar();
+    if (!kt) return false;
+    try {
+      return await kt.deletePassword(this.service, key);
+    } catch {
+      return false;
+    }
+  }
+  async clear() {
+    const kt = await getKeytar();
+    if (!kt) return;
+    try {
+      const credentials = await kt.findCredentials(this.service);
+      for (const cred of credentials) {
+        await kt.deletePassword(this.service, cred.account);
+      }
+    } catch {
+    }
+  }
+};
+
+// src/storage/cli-token-manager.ts
+var CliTokenManager = class {
+  keychain;
+  fileStorage;
+  keychainAvailable = null;
+  constructor() {
+    this.keychain = new KeychainStorage();
+    this.fileStorage = new FileStorage();
+  }
+  async useKeychain() {
+    if (this.keychainAvailable === null) {
+      this.keychainAvailable = await this.keychain.isAvailable();
+    }
+    return this.keychainAvailable;
+  }
+  async getToken() {
+    if (await this.useKeychain()) {
+      const token = await this.keychain.get(TOKEN_KEYS.ACCESS_TOKEN);
+      if (token) return token;
+    }
+    return await this.fileStorage.get(TOKEN_KEYS.ACCESS_TOKEN);
+  }
+  async setToken(token) {
+    if (await this.useKeychain()) {
+      const success = await this.keychain.set(TOKEN_KEYS.ACCESS_TOKEN, token);
+      if (success) return;
+    }
+    await this.fileStorage.set(TOKEN_KEYS.ACCESS_TOKEN, token);
+  }
+  async clearToken() {
+    await this.keychain.delete(TOKEN_KEYS.ACCESS_TOKEN);
+    await this.fileStorage.delete(TOKEN_KEYS.ACCESS_TOKEN);
+  }
+  async getRefreshToken() {
+    if (await this.useKeychain()) {
+      const token = await this.keychain.get(TOKEN_KEYS.REFRESH_TOKEN);
+      if (token) return token;
+    }
+    return await this.fileStorage.get(TOKEN_KEYS.REFRESH_TOKEN);
+  }
+  async setRefreshToken(token) {
+    if (await this.useKeychain()) {
+      const success = await this.keychain.set(TOKEN_KEYS.REFRESH_TOKEN, token);
+      if (success) return;
+    }
+    await this.fileStorage.set(TOKEN_KEYS.REFRESH_TOKEN, token);
+  }
+  async clearRefreshToken() {
+    await this.keychain.delete(TOKEN_KEYS.REFRESH_TOKEN);
+    await this.fileStorage.delete(TOKEN_KEYS.REFRESH_TOKEN);
+  }
+  async getUserEmail() {
+    if (await this.useKeychain()) {
+      const email = await this.keychain.get(TOKEN_KEYS.USER_EMAIL);
+      if (email) return email;
+    }
+    return await this.fileStorage.get(TOKEN_KEYS.USER_EMAIL);
+  }
+  async setUserEmail(email) {
+    if (await this.useKeychain()) {
+      const success = await this.keychain.set(TOKEN_KEYS.USER_EMAIL, email);
+      if (success) return;
+    }
+    await this.fileStorage.set(TOKEN_KEYS.USER_EMAIL, email);
+  }
+  // GitHub token for private template access (persists after logout)
+  async getGithubToken() {
+    if (await this.useKeychain()) {
+      const token = await this.keychain.get(TOKEN_KEYS.GITHUB_TOKEN);
+      if (token) return token;
+    }
+    return await this.fileStorage.get(TOKEN_KEYS.GITHUB_TOKEN);
+  }
+  async setGithubToken(token) {
+    if (await this.useKeychain()) {
+      const success = await this.keychain.set(TOKEN_KEYS.GITHUB_TOKEN, token);
+      if (success) return;
+    }
+    await this.fileStorage.set(TOKEN_KEYS.GITHUB_TOKEN, token);
+  }
+  async clearAll() {
+    const githubToken = await this.getGithubToken();
+    await this.keychain.clear();
+    await this.fileStorage.clear();
+    if (githubToken) {
+      await this.setGithubToken(githubToken);
+    }
+  }
+  async isLoggedIn() {
+    const token = await this.getToken();
+    return token !== null;
+  }
+};
+var instance = null;
+function getTokenManager() {
+  if (!instance) {
+    instance = new CliTokenManager();
+  }
+  return instance;
+}
+var defaults = {
+  telemetryEnabled: true
+};
+var ConfigManager = class {
+  config;
+  constructor() {
+    this.config = new Conf({
+      projectName: CLI_NAME,
+      defaults
+    });
+  }
+  get(key) {
+    return this.config.get(key);
+  }
+  set(key, value) {
+    this.config.set(key, value);
+  }
+  delete(key) {
+    this.config.delete(key);
+  }
+  getAll() {
+    return this.config.store;
+  }
+  clear() {
+    this.config.clear();
+  }
+  get path() {
+    return this.config.path;
+  }
+};
+var configManager = new ConfigManager();
+var logger = {
+  success(message) {
+    console.info(chalk4.green("\u2713"), message);
+  },
+  error(message) {
+    console.error(chalk4.red("\u2717"), message);
+  },
+  warn(message) {
+    console.warn(chalk4.yellow("\u26A0"), message);
+  },
+  info(message) {
+    console.info(chalk4.blue("\u2139"), message);
+  },
+  debug(message) {
+    if (process.env.DEBUG) {
+      console.debug(chalk4.gray("\u22EF"), chalk4.gray(message));
+    }
+  },
+  log(message) {
+    console.info(message);
+  },
+  newline() {
+    console.info();
+  },
+  dim(message) {
+    console.info(chalk4.dim(message));
+  },
+  bold(message) {
+    console.info(chalk4.bold(message));
+  },
+  link(url) {
+    return chalk4.cyan.underline(url);
+  }
+};
+var state = {
+  format: "text",
+  data: {}
+};
+var output = {
+  setFormat(format) {
+    state.format = format;
+  },
+  getFormat() {
+    return state.format;
+  },
+  isJson() {
+    return state.format === "json";
+  },
+  // Accumulate data for JSON output
+  set(key, value) {
+    state.data[key] = value;
+  },
+  // Clear accumulated data
+  clear() {
+    state.data = {};
+  },
+  // Print success message or accumulate for JSON
+  success(message, data) {
+    if (state.format === "json") {
+      state.data = {
+        ...state.data,
+        ...data,
+        success: true,
+        message
+      };
+    } else {
+      console.info(chalk4.green("\u2713"), message);
+    }
+  },
+  // Print error message or accumulate for JSON
+  error(message, data) {
+    if (state.format === "json") {
+      state.data = {
+        ...state.data,
+        ...data,
+        success: false,
+        error: message
+      };
+    } else {
+      console.error(chalk4.red("\u2717"), message);
+    }
+  },
+  // Print warning message
+  warn(message) {
+    if (state.format === "json") {
+      state.data.warning = message;
+    } else {
+      console.warn(chalk4.yellow("\u26A0"), message);
+    }
+  },
+  // Print info message (only in text mode)
+  info(message) {
+    if (state.format !== "json") {
+      console.info(chalk4.blue("\u2139"), message);
+    }
+  },
+  // Print dim message (only in text mode)
+  dim(message) {
+    if (state.format !== "json") {
+      console.info(chalk4.dim(message));
+    }
+  },
+  // Print the final JSON output
+  flush() {
+    if (state.format === "json" && Object.keys(state.data).length > 0) {
+      console.info(JSON.stringify(state.data, null, 2));
+      state.data = {};
+    }
+  },
+  // Direct JSON output (for commands that return structured data)
+  json(data) {
+    if (state.format === "json") {
+      console.info(JSON.stringify(data, null, 2));
+    }
+  }
+};
+
+// src/ui/messages.ts
+var MESSAGES = {
+  // Login
+  LOGIN_SUCCESS: (email) => `Successfully logged in as ${email}`,
+  LOGIN_FAILED: "Login failed. Please check your credentials.",
+  LOGIN_PROMPT_EMAIL: "Email:",
+  LOGIN_PROMPT_PASSWORD: "Password:",
+  LOGIN_AUTHENTICATING: "Authenticating...",
+  // SSO
+  SSO_OPENING_BROWSER: "Opening browser for authentication...",
+  SSO_WAITING: "Waiting for browser authentication...",
+  SSO_SUCCESS: "Browser authentication successful!",
+  SSO_TIMEOUT: "Authentication timed out. Please try again.",
+  SSO_CANCELLED: "Authentication cancelled.",
+  // Logout
+  LOGOUT_SUCCESS: "Successfully logged out.",
+  LOGOUT_CONFIRM: "Are you sure you want to log out?",
+  LOGOUT_IN_PROGRESS: "Logging out...",
+  // Whoami
+  WHOAMI_NOT_LOGGED_IN: "You are not logged in.",
+  WHOAMI_SUGGESTION: "Run `docyrus login` to authenticate.",
+  WHOAMI_FETCHING: "Fetching user info...",
+  // General
+  NOT_LOGGED_IN: "You are not logged in.",
+  NETWORK_ERROR: "Network request failed. Please check your internet connection.",
+  UNKNOWN_ERROR: "An unexpected error occurred.",
+  // Errors
+  INVALID_CREDENTIALS: "Invalid email or password.",
+  SESSION_EXPIRED: "Your session has expired. Please log in again.",
+  SERVER_ERROR: "Server error. Please try again later.",
+  // Create command
+  CREATE_SELECT_FRAMEWORK: "Select a framework:",
+  CREATE_SELECT_UI_LIBRARY: "Select UI library:",
+  CREATE_SELECT_LINTER: "Select linter/formatter:",
+  CREATE_PROJECT_NAME: "Project name:",
+  CREATE_SELECT_PACKAGE_MANAGER: "Select package manager:",
+  CREATE_CUSTOMIZE_ALIAS: "Customize import alias? (default: @/)",
+  CREATE_CUSTOM_ALIAS: "Enter import alias prefix (must start with @):",
+  CREATE_SETTING_UP: "Creating project...",
+  CREATE_DOWNLOADING: "Downloading project template...",
+  CREATE_COPYING_LOCAL: "Copying local template...",
+  CREATE_CONFIGURING_LINTER: (linter) => `Configuring ${linter}...`,
+  CREATE_CONFIGURING_ALIAS: (alias) => `Configuring import alias (${alias}/)...`,
+  CREATE_INSTALLING: "Installing dependencies...",
+  CREATE_SUCCESS: "Project created successfully!",
+  CREATE_DOWNLOAD_OPENAPI: "Download OpenAPI spec for code generation?",
+  CREATE_DOWNLOADING_OPENAPI: "Downloading OpenAPI specification...",
+  CREATE_OPENAPI_SUCCESS: (path) => `OpenAPI spec saved to ${path}`,
+  // Linter Setup
+  LINTER_SETUP_TITLE: "Setting up Linter...",
+  // State Management
+  CREATE_SELECT_STATE_MANAGEMENT: "Select state management:",
+  STATE_MANAGEMENT_SETUP_TITLE: "Setting up State Management...",
+  // OpenAPI Setup
+  OPENAPI_SETUP_TITLE: "Setting up API...",
+  // API Client
+  API_CLIENT_DOCS: "API Client: https://www.npmjs.com/package/@docyrus/api-client",
+  // UI Library Setup
+  UI_SETUP_TITLE: "Setting up UI Library...",
+  UI_MULTIPLE_LIBRARIES: "Cannot use multiple UI libraries together",
+  // Docyrus Token (for private template access)
+  DOCYRUS_TOKEN_REQUIRED: "Docyrus token required for template download",
+  DOCYRUS_TOKEN_PROMPT: "Enter Docyrus token:",
+  DOCYRUS_TOKEN_SAVED: "Docyrus token saved successfully",
+  DOCYRUS_TOKEN_INVALID: "Invalid Docyrus token. Please check and try again."
+};
+function createSpinner(text) {
+  return ora({
+    text,
+    spinner: "dots"
+  });
+}
+async function withSpinner(text, fn, options) {
+  if (options?.silent) {
+    return fn();
+  }
+  const spinner = createSpinner(text).start();
+  try {
+    const result = await fn();
+    if (options?.successText) {
+      spinner.succeed(options.successText);
+    } else {
+      spinner.stop();
+    }
+    return result;
+  } catch (error) {
+    if (options?.failText) {
+      spinner.fail(options.failText);
+    } else {
+      spinner.stop();
+    }
+    throw error;
+  }
+}
+async function promptEmail(defaultValue) {
+  return input({
+    message: MESSAGES.LOGIN_PROMPT_EMAIL,
+    default: defaultValue,
+    validate: (value) => {
+      if (!value || !value.includes("@")) {
+        return "Please enter a valid email address.";
+      }
+      return true;
+    }
+  });
+}
+async function promptPassword() {
+  return password({
+    message: MESSAGES.LOGIN_PROMPT_PASSWORD,
+    mask: "*",
+    validate: (value) => {
+      if (!value || value.length < 1) {
+        return "Please enter your password.";
+      }
+      return true;
+    }
+  });
+}
+({
+  pending: chalk4.dim("\u25CB"),
+  in_progress: chalk4.cyan("\u25D0"),
+  completed: chalk4.green("\u2713"),
+  failed: chalk4.red("\u2717")
+});
+function createSimpleProgress() {
+  let spinner = null;
+  return (step, current, total) => {
+    if (spinner) {
+      spinner.succeed();
+      spinner = null;
+    }
+    const text = current && total ? `${step} (${current}/${total})` : step;
+    spinner = ora({
+      text,
+      color: "cyan"
+    }).start();
+    if (current && total && current === total) {
+      spinner.succeed();
+      spinner = null;
+    }
+  };
+}
+
+// src/commands/login.ts
+async function handleCredentialLogin(email) {
+  const lastEmail = configManager.get("lastLoginEmail");
+  const userEmail = email || await promptEmail(lastEmail);
+  const password4 = await promptPassword();
+  const result = await withSpinner(
+    MESSAGES.LOGIN_AUTHENTICATING,
+    () => loginWithCredentials({ email: userEmail, password: password4 })
+  );
+  const tokenManager = getTokenManager();
+  await tokenManager.setToken(result.tokens.accessToken);
+  if (result.tokens.refreshToken) {
+    await tokenManager.setRefreshToken(result.tokens.refreshToken);
+  }
+  const finalEmail = result.user?.email || userEmail;
+  await tokenManager.setUserEmail(finalEmail);
+  configManager.set("lastLoginEmail", finalEmail);
+  output.success(MESSAGES.LOGIN_SUCCESS(finalEmail), { email: finalEmail });
+}
+async function handleSsoLogin() {
+  const result = await loginWithOAuth({
+    onOpeningBrowser: () => {
+      logger.info(MESSAGES.SSO_OPENING_BROWSER);
+    },
+    onWaitingForAuth: (url) => {
+      logger.dim(`  ${url}`);
+      logger.info(MESSAGES.SSO_WAITING);
+    }
+  });
+  const tokenManager = getTokenManager();
+  await tokenManager.setToken(result.tokens.accessToken);
+  if (result.tokens.refreshToken) {
+    await tokenManager.setRefreshToken(result.tokens.refreshToken);
+  }
+  let email = result.user?.email;
+  if (!email && result.tokens.accessToken) {
+    try {
+      const userInfo2 = await getUserInfo(result.tokens.accessToken);
+      ({ email } = userInfo2);
+    } catch {
+    }
+  }
+  if (email) {
+    await tokenManager.setUserEmail(email);
+    configManager.set("lastLoginEmail", email);
+    output.success(MESSAGES.LOGIN_SUCCESS(email), { email });
+  } else {
+    output.success("Successfully logged in.");
+  }
+}
+function registerLoginCommand(program2) {
+  program2.command("login").description("Log in to Docyrus (uses browser-based SSO by default)").option("-e, --email [email]", "Log in with email/password instead of SSO").action(async (options) => {
+    try {
+      const tokenManager = getTokenManager();
+      if (await tokenManager.isLoggedIn()) {
+        const email = await tokenManager.getUserEmail();
+        output.warn(`Already logged in${email ? ` as ${email}` : ""}. Run \`docyrus logout\` first to log in as a different user.`);
+        return;
+      }
+      if (options.email !== void 0) {
+        const emailValue = typeof options.email === "string" ? options.email : void 0;
+        await handleCredentialLogin(emailValue);
+      } else {
+        await handleSsoLogin();
+      }
+    } catch (error) {
+      if (error instanceof AuthenticationError) {
+        output.error(error.message);
+        if (error.suggestion && !output.isJson()) {
+          logger.dim(error.suggestion);
+        }
+        process.exit(error.exitCode);
+      }
+      throw error;
+    }
+  });
+}
+
+// src/commands/logout.ts
+function registerLogoutCommand(program2) {
+  program2.command("logout").description("Log out from Docyrus").action(async () => {
+    const tokenManager = getTokenManager();
+    if (!await tokenManager.isLoggedIn()) {
+      output.warn(MESSAGES.WHOAMI_NOT_LOGGED_IN);
+      return;
+    }
+    const email = await tokenManager.getUserEmail();
+    await withSpinner(
+      MESSAGES.LOGOUT_IN_PROGRESS,
+      async () => {
+        await tokenManager.clearAll();
+      },
+      { silent: output.isJson() }
+    );
+    output.success(MESSAGES.LOGOUT_SUCCESS, email ? { email } : void 0);
+    if (email && !output.isJson()) {
+      logger.dim(`Logged out from ${email}`);
+    }
+  });
+}
+
+// src/utils/auth-guard.ts
+function decodeJwtPayload(token) {
+  try {
+    const parts = token.split(".");
+    if (parts.length !== 3) return null;
+    const payload = Buffer.from(parts[1], "base64url").toString("utf8");
+    return JSON.parse(payload);
+  } catch {
+    return null;
+  }
+}
+function isTokenExpired(token) {
+  const payload = decodeJwtPayload(token);
+  if (!payload?.exp) return false;
+  const expirationTime = payload.exp * 1e3;
+  const now = Date.now();
+  return now >= expirationTime - 3e4;
+}
+async function requireAuth() {
+  const tokenManager = getTokenManager();
+  if (!await tokenManager.isLoggedIn()) {
+    throw new NotLoggedInError();
+  }
+  let token = await tokenManager.getToken();
+  if (!token) {
+    throw new NotLoggedInError();
+  }
+  if (isTokenExpired(token)) {
+    const refreshToken = await tokenManager.getRefreshToken();
+    if (!refreshToken) {
+      await tokenManager.clearAll();
+      throw new NotLoggedInError("Your session has expired. Please log in again.");
+    }
+    try {
+      const newTokens = await refreshAccessToken(refreshToken);
+      await tokenManager.setToken(newTokens.accessToken);
+      if (newTokens.refreshToken) {
+        await tokenManager.setRefreshToken(newTokens.refreshToken);
+      }
+      token = newTokens.accessToken;
+    } catch (error) {
+      await tokenManager.clearAll();
+      if (error instanceof AuthenticationError) {
+        throw new NotLoggedInError("Your session has expired. Please log in again.");
+      }
+      throw error;
+    }
+  }
+  return token;
+}
+
+// src/commands/whoami.ts
+function registerWhoamiCommand(program2) {
+  program2.command("whoami").description("Display the current logged-in user").action(async () => {
+    const tokenManager = getTokenManager();
+    const token = await requireAuth();
+    try {
+      const user = await withSpinner(
+        MESSAGES.WHOAMI_FETCHING,
+        () => getUserInfo(token),
+        { silent: output.isJson() }
+      );
+      if (output.isJson()) {
+        output.set("user", {
+          email: user.email,
+          firstname: user.firstname,
+          lastname: user.lastname
+        });
+      } else {
+        logger.newline();
+        logger.log(`Email: ${user.email}`);
+        if (user.firstname || user.lastname) {
+          const fullName = [user.firstname, user.lastname].filter(Boolean).join(" ");
+          logger.log(`Name:  ${fullName}`);
+        }
+        logger.newline();
+      }
+    } catch (error) {
+      const cachedEmail = await tokenManager.getUserEmail();
+      if (cachedEmail) {
+        if (output.isJson()) {
+          output.set("user", { email: cachedEmail, cached: true });
+        } else {
+          logger.newline();
+          logger.log(`Email: ${cachedEmail}`);
+          logger.dim("(Unable to fetch full profile from server)");
+          logger.newline();
+        }
+      } else {
+        throw error;
+      }
+    }
+  });
+}
+var ESLINT_CONFIGS = {
+  react: {
+    imports: ["baseConfig", "reactConfig"],
+    configs: ["...baseConfig", "...reactConfig"]
+  },
+  nextjs: {
+    imports: [
+      "baseConfig",
+      "reactConfig",
+      "nextjsConfig"
+    ],
+    configs: [
+      "...baseConfig",
+      "...reactConfig",
+      "...nextjsConfig"
+    ]
+  },
+  vue: {
+    imports: ["baseConfig", "vueConfig"],
+    configs: ["...baseConfig", "...vueConfig"]
+  },
+  electron: {
+    imports: ["baseConfig", "electronConfig"],
+    configs: ["...baseConfig", "...electronConfig"]
+  }
+};
+function generateEslintConfig(framework) {
+  const { imports, configs } = ESLINT_CONFIGS[framework];
+  return `import { ${imports.join(", ")} } from '@docyrus/rules/eslint';
+
+export default [${configs.join(", ")}];
+`;
+}
+function generateBiomeConfig(framework) {
+  return `${JSON.stringify({ extends: [`@docyrus/rules/biome/${framework}`] }, null, 2)}
+`;
+}
+async function applyLinterConfig(targetDir, framework, linter, onProgress) {
+  if (linter === "none") return;
+  const linterName = linter === "eslint" ? "ESLint" : "Biome";
+  onProgress(`Generating ${linterName} config...`, 1, 2);
+  if (linter === "eslint") {
+    await writeFile(join(targetDir, "eslint.config.mjs"), generateEslintConfig(framework));
+  } else {
+    await writeFile(join(targetDir, "biome.json"), generateBiomeConfig(framework));
+  }
+  onProgress("Updating package.json...", 2, 2);
+  const targetPkgPath = join(targetDir, "package.json");
+  const targetPkg = JSON.parse(await readFile(targetPkgPath, "utf-8"));
+  let devDependencies;
+  let scripts;
+  if (linter === "eslint") {
+    devDependencies = { "@docyrus/rules": "latest", eslint: "latest" };
+    scripts = { lint: "eslint .", format: "eslint --fix ." };
+  } else {
+    devDependencies = { "@docyrus/rules": "latest", "@biomejs/biome": "latest" };
+    scripts = { lint: "biome check .", format: "biome check --fix ." };
+  }
+  targetPkg.devDependencies = {
+    ...targetPkg.devDependencies,
+    ...devDependencies
+  };
+  targetPkg.scripts = {
+    ...targetPkg.scripts,
+    ...scripts
+  };
+  await writeFile(targetPkgPath, JSON.stringify(targetPkg, null, 2));
+}
+async function applyAliasConfig(targetDir, framework, aliasPrefix) {
+  if (aliasPrefix === "@" || aliasPrefix === "@/") return;
+  const config = {
+    prefix: aliasPrefix,
+    pattern: `${aliasPrefix}/*`,
+    replacement: "./src/*"
+  };
+  await updateTsConfig(targetDir, config);
+  if (framework === "react" || framework === "vue" || framework === "electron") {
+    await updateViteConfig(targetDir, config);
+  }
+  await updateImports(targetDir, aliasPrefix, framework);
+}
+async function updateTsConfig(targetDir, config) {
+  const tsconfigPath = join(targetDir, "tsconfig.json");
+  const tsconfig = JSON.parse(await readFile(tsconfigPath, "utf-8"));
+  if (tsconfig.compilerOptions?.paths) {
+    delete tsconfig.compilerOptions.paths["@/*"];
+    tsconfig.compilerOptions.paths[config.pattern] = [config.replacement];
+  }
+  await writeFile(tsconfigPath, JSON.stringify(tsconfig, null, 2));
+}
+async function updateViteConfig(targetDir, config) {
+  const vitePath = join(targetDir, "vite.config.ts");
+  try {
+    let content = await readFile(vitePath, "utf-8");
+    content = content.replace(
+      /'@':\s*resolve\(/g,
+      `'${config.prefix}': resolve(`
+    );
+    await writeFile(vitePath, content);
+  } catch {
+  }
+}
+async function updateImports(targetDir, newPrefix, framework) {
+  const srcDir = join(targetDir, "src");
+  try {
+    await updateImportsRecursive(srcDir, newPrefix, framework);
+  } catch {
+  }
+}
+function getFileExtensions(framework) {
+  switch (framework) {
+    case "vue":
+      return [
+        ".ts",
+        ".tsx",
+        ".vue"
+      ];
+    default:
+      return [".ts", ".tsx"];
+  }
+}
+async function updateImportsRecursive(dir, newPrefix, framework) {
+  const entries = await readdir(dir, { withFileTypes: true });
+  const extensions = getFileExtensions(framework);
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await updateImportsRecursive(fullPath, newPrefix, framework);
+    } else if (extensions.some((ext) => entry.name.endsWith(ext))) {
+      const content = await readFile(fullPath, "utf-8");
+      const updatedContent = content.replace(
+        /from\s+['"]@\//g,
+        `from '${newPrefix}/`
+      );
+      if (updatedContent !== content) {
+        await writeFile(fullPath, updatedContent);
+      }
+    }
+  }
+}
+function createAuthenticatedClient(accessToken) {
+  const apiUrl = configManager.get("apiUrl") || DOCYRUS_API_URL;
+  const client = new RestApiClient({ baseURL: apiUrl });
+  client.setAccessToken(accessToken);
+  return client;
+}
+async function downloadOpenApiSpec(accessToken, targetDir, filename = "openapi.json") {
+  const client = createAuthenticatedClient(accessToken);
+  const spec = await client.get("/v1/api/openapi.json");
+  const targetPath = join(targetDir, filename);
+  const targetDirPath = dirname(targetPath);
+  await mkdir(targetDirPath, { recursive: true });
+  await writeFile(targetPath, JSON.stringify(spec, null, 2));
+  return targetPath;
+}
+async function applyUIVariants(targetDir, uiLibrary) {
+  const variantsDir = join(targetDir, "__ui-variants__");
+  try {
+    await access(variantsDir, constants$1.F_OK);
+  } catch {
+    return;
+  }
+  if (uiLibrary !== "none") {
+    const libraryDir = join(variantsDir, uiLibrary);
+    try {
+      await access(libraryDir, constants$1.F_OK);
+      await cp(libraryDir, targetDir, { recursive: true, force: true });
+    } catch {
+    }
+  }
+  await rm(variantsDir, { recursive: true, force: true });
+}
+var execAsync = promisify(exec);
+function parseEnvArray(value) {
+  if (!value) {
+    throw new Error("Missing environment variable");
+  }
+  return value.split(",").map((s) => s.trim());
+}
+var SHADCN_BASE_COLORS = parseEnvArray("zinc,slate,neutral,stone,gray");
+parseEnvArray("vega,nova,maia,lyra,mira");
+var DICEUI_COMPONENTS = parseEnvArray("action-bar,avatar-group,badge-overflow,checkbox-group,circular-progress,color-picker,color-swatch,combobox,compare-slider,cropper,editable,file-upload,gauge,kanban,key-value,listbox,mask-input,media-player,mention,phone-input,qr-code,rating,relative-time-card,responsive-dialog,scroll-spy,scroller,segmented-input,sortable,speed-dial,stack,stat,status,stepper,swap,tags-input,time-picker,timeline,tour");
+var UI_LIBRARY_COMPATIBILITY = {
+  nextjs: [
+    "shadcn",
+    "diceui",
+    "heroui",
+    "none"
+  ],
+  react: [
+    "shadcn",
+    "diceui",
+    "heroui",
+    "none"
+  ],
+  vue: ["shadcn-vue", "none"],
+  electron: [
+    "shadcn",
+    "diceui",
+    "none"
+  ]
+};
+function isUILibraryCompatible(framework, uiLibrary) {
+  return UI_LIBRARY_COMPATIBILITY[framework].includes(uiLibrary);
+}
+function getUILibraryErrorMessage(framework, uiLibrary) {
+  switch (uiLibrary) {
+    case "heroui":
+      if (framework === "electron") {
+        return "HeroUI is not supported with Electron due to framer-motion compatibility issues. Use --shadcn or --diceui instead";
+      }
+      return `HeroUI only supports Next.js and React frameworks. Current: ${framework}`;
+    case "shadcn":
+    case "diceui":
+      if (framework === "vue") {
+        return "Use --shadcn-vue for Vue projects instead of --shadcn or --diceui";
+      }
+      return `shadcn/ui is not supported with ${framework}`;
+    case "shadcn-vue":
+      return `shadcn-vue is only for Vue projects. Use --shadcn or --diceui for ${framework}`;
+    default:
+      return `${uiLibrary} is not compatible with ${framework}`;
+  }
+}
+async function setupShadcn(targetDir, packageManager, style, baseColor, onProgress) {
+  const dlx = getDlxCommand(packageManager);
+  onProgress("Initializing shadcn/ui (Base UI)...", 1, 4);
+  await execAsync(`${dlx} shadcn@latest init --yes --defaults -b ${baseColor}`, {
+    cwd: targetDir,
+    timeout: 3e5
+  });
+  onProgress("Migrating to Radix UI...", 2, 4);
+  await execAsync(`${dlx} shadcn@latest migrate radix --yes`, {
+    cwd: targetDir,
+    timeout: 12e4
+  });
+  onProgress("Updating style configuration...", 3, 4);
+  const componentsJsonPath = join(targetDir, "components.json");
+  const componentsJson = JSON.parse(await readFile(componentsJsonPath, "utf-8"));
+  componentsJson.style = `radix-${style}`;
+  await writeFile(componentsJsonPath, JSON.stringify(componentsJson, null, 2));
+  onProgress("Installing shadcn components...", 4, 4);
+  await execAsync(`${dlx} shadcn@latest add --all --yes --overwrite`, {
+    cwd: targetDir,
+    timeout: 3e5
+  });
+}
+async function setupDiceUI(targetDir, packageManager, style, baseColor, onProgress) {
+  const dlx = getDlxCommand(packageManager);
+  onProgress("Initializing shadcn/ui (Base UI)...", 1, 5);
+  await execAsync(`${dlx} shadcn@latest init --yes --defaults -b ${baseColor}`, {
+    cwd: targetDir,
+    timeout: 3e5
+  });
+  onProgress("Migrating to Radix UI...", 2, 5);
+  await execAsync(`${dlx} shadcn@latest migrate radix --yes`, {
+    cwd: targetDir,
+    timeout: 12e4
+  });
+  onProgress("Updating style configuration...", 3, 5);
+  const componentsJsonPath = join(targetDir, "components.json");
+  const componentsJson = JSON.parse(await readFile(componentsJsonPath, "utf-8"));
+  componentsJson.style = `radix-${style}`;
+  await writeFile(componentsJsonPath, JSON.stringify(componentsJson, null, 2));
+  onProgress("Installing shadcn components...", 4, 5);
+  await execAsync(`${dlx} shadcn@latest add --all --yes --overwrite`, {
+    cwd: targetDir,
+    timeout: 3e5
+  });
+  onProgress("Installing DiceUI components...", 5, 5);
+  for (const component of DICEUI_COMPONENTS) {
+    await execAsync(`${dlx} shadcn@latest add https://shadcn-extension.vercel.app/r/diceui/${component}.json --yes --overwrite`, {
+      cwd: targetDir,
+      timeout: 6e4
+    });
+  }
+}
+async function setupShadcnVue(targetDir, packageManager, onProgress) {
+  const dlx = getDlxCommand(packageManager);
+  onProgress("Initializing shadcn-vue...", 1, 2);
+  await execAsync(`${dlx} shadcn-vue@latest init -y -d`, {
+    cwd: targetDir,
+    timeout: 12e4
+  });
+  onProgress("Installing shadcn-vue components...", 2, 2);
+  await execAsync(`${dlx} shadcn-vue@latest add -a -y -o`, {
+    cwd: targetDir,
+    timeout: 3e5
+  });
+}
+async function setupHeroUI(targetDir, framework, packageManager, onProgress) {
+  onProgress("Adding HeroUI dependencies...", 1, 3);
+  const installCmd = getInstallCommand(packageManager);
+  await execAsync(`${installCmd} @heroui/react framer-motion`, {
+    cwd: targetDir,
+    timeout: 12e4
+  });
+  onProgress("Configuring styles...", 2, 3);
+  await writeHeroUIStyles(targetDir);
+  onProgress("Adding HeroUIProvider...", 3, 3);
+  await addHeroUIProvider(targetDir, framework);
+}
+async function setupUILibrary(targetDir, framework, uiLibrary, packageManager, onProgress, style, baseColor) {
+  if (uiLibrary === "none") {
+    return;
+  }
+  if (!isUILibraryCompatible(framework, uiLibrary)) {
+    throw new Error(getUILibraryErrorMessage(framework, uiLibrary));
+  }
+  switch (uiLibrary) {
+    case "shadcn":
+      await setupShadcn(
+        targetDir,
+        packageManager,
+        style ?? "vega",
+        baseColor ?? "zinc",
+        onProgress
+      );
+      break;
+    case "diceui":
+      await setupDiceUI(
+        targetDir,
+        packageManager,
+        style ?? "vega",
+        baseColor ?? "zinc",
+        onProgress
+      );
+      break;
+    case "shadcn-vue":
+      await setupShadcnVue(targetDir, packageManager, onProgress);
+      break;
+    case "heroui":
+      await setupHeroUI(targetDir, framework, packageManager, onProgress);
+      break;
+  }
+}
+function getDlxCommand(packageManager) {
+  switch (packageManager) {
+    case "pnpm":
+      return "pnpx";
+    case "yarn":
+      return "yarn dlx";
+    case "bun":
+      return "bunx";
+    default:
+      return "npx";
+  }
+}
+function getInstallCommand(packageManager) {
+  switch (packageManager) {
+    case "pnpm":
+      return "pnpm add";
+    case "yarn":
+      return "yarn add";
+    case "bun":
+      return "bun add";
+    default:
+      return "npm install";
+  }
+}
+async function writeHeroUIStyles(targetDir) {
+  const possibleCssPaths = [join(targetDir, "src/styles/globals.css"), join(targetDir, "src/styles/global.css")];
+  const css = `@import "tailwindcss";
+@plugin "@heroui/react/tailwind";
+`;
+  for (const cssPath of possibleCssPaths) {
+    try {
+      await readFile(cssPath, "utf-8");
+      await writeFile(cssPath, css, "utf-8");
+      return;
+    } catch {
+    }
+  }
+}
+async function addHeroUIProvider(targetDir, framework) {
+  if (framework === "nextjs") {
+    await addHeroUIProviderNextjs(targetDir);
+  } else {
+    await addHeroUIProviderReact(targetDir);
+  }
+}
+async function addHeroUIProviderNextjs(targetDir) {
+  const providersPath = join(targetDir, "src/app/providers.tsx");
+  const providersContent = `'use client';
+
+import { HeroUIProvider } from '@heroui/react';
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return <HeroUIProvider>{children}</HeroUIProvider>;
+}
+`;
+  await writeFile(providersPath, providersContent, "utf-8");
+  const layoutPath = join(targetDir, "src/app/layout.tsx");
+  try {
+    let layoutContent = await readFile(layoutPath, "utf-8");
+    if (!layoutContent.includes("Providers")) {
+      layoutContent = layoutContent.replace(
+        /^(import.*\n)+/m,
+        (match) => `${match}import { Providers } from './providers';
+`
+      );
+      layoutContent = layoutContent.replace(
+        /(<body[^>]*>)([\s\S]*?)({children})([\s\S]*?)(<\/body>)/,
+        "$1$2<Providers>$3</Providers>$4$5"
+      );
+      await writeFile(layoutPath, layoutContent, "utf-8");
+    }
+  } catch {
+  }
+}
+async function addHeroUIProviderReact(targetDir) {
+  const mainPath = join(targetDir, "src/main.tsx");
+  try {
+    let content = await readFile(mainPath, "utf-8");
+    if (!content.includes("HeroUIProvider")) {
+      content = content.replace(
+        /^(import.*\n)+/m,
+        (match) => `${match}import { HeroUIProvider } from '@heroui/react';
+`
+      );
+      content = content.replace(
+        /(<App\s*\/>)/,
+        "<HeroUIProvider>\n    $1\n  </HeroUIProvider>"
+      );
+      await writeFile(mainPath, content, "utf-8");
+    }
+  } catch {
+  }
+}
+var STATE_MANAGEMENT_VERSIONS = {
+  zustand: { name: "zustand", version: "5.0.11" },
+  "tanstack-query": { name: "@tanstack/react-query", version: "5.90.20" },
+  "tanstack-vue-query": { name: "@tanstack/vue-query", version: "5.92.9" }
+};
+function getCompatibleStateManagement(framework) {
+  switch (framework) {
+    case "react":
+    case "nextjs":
+    case "electron":
+      return [
+        "zustand",
+        "tanstack-query",
+        "none"
+      ];
+    case "vue":
+      return ["tanstack-vue-query", "none"];
+    default:
+      return [];
+  }
+}
+async function setupStateManagement(targetDir, framework, stateManagement, onProgress) {
+  if (stateManagement === "none") return;
+  const totalSteps = stateManagement === "zustand" ? 2 : 3;
+  onProgress("Adding dependency...", 1, totalSteps);
+  const pkg = STATE_MANAGEMENT_VERSIONS[stateManagement];
+  await addDependencyToPackageJson(targetDir, pkg.name, pkg.version);
+  onProgress("Creating configuration...", 2, totalSteps);
+  switch (stateManagement) {
+    case "zustand":
+      await createZustandStore(targetDir);
+      break;
+    case "tanstack-query":
+      await createReactQueryClient(targetDir);
+      break;
+    case "tanstack-vue-query":
+      await createVueQueryConfig(targetDir);
+      break;
+  }
+  if (stateManagement !== "zustand") {
+    onProgress("Configuring provider...", 3, totalSteps);
+    if (stateManagement === "tanstack-query") {
+      await wrapReactQueryProvider(targetDir, framework);
+    } else if (stateManagement === "tanstack-vue-query") {
+      await wrapVueQueryPlugin(targetDir);
+    }
+  }
+}
+async function addDependencyToPackageJson(targetDir, name, version) {
+  const pkgPath = join(targetDir, "package.json");
+  const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
+  pkg.dependencies = pkg.dependencies ?? {};
+  pkg.dependencies[name] = version;
+  await writeFile(pkgPath, JSON.stringify(pkg, null, 2), "utf-8");
+}
+async function createZustandStore(targetDir) {
+  const storePath = join(targetDir, "src/store/app-store.ts");
+  await mkdir(dirname(storePath), { recursive: true });
+  await writeFile(storePath, `import { create } from 'zustand';
+
+interface AppState {
+  count: number;
+  increment: () => void;
+  decrement: () => void;
+}
+
+export const useAppStore = create<AppState>((set) => ({
+  count: 0,
+  increment: () => set((state) => ({ count: state.count + 1 })),
+  decrement: () => set((state) => ({ count: state.count - 1 }))
+}));
+`, "utf-8");
+}
+async function createReactQueryClient(targetDir) {
+  const clientPath = join(targetDir, "src/lib/query-client.ts");
+  await mkdir(dirname(clientPath), { recursive: true });
+  await writeFile(clientPath, `import { QueryClient } from '@tanstack/react-query';
+
+export const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      staleTime: 60 * 1000,
+      retry: 1
+    }
+  }
+});
+`, "utf-8");
+}
+async function createVueQueryConfig(targetDir) {
+  const configPath = join(targetDir, "src/lib/query-client.ts");
+  await mkdir(dirname(configPath), { recursive: true });
+  await writeFile(configPath, `import type { VueQueryPluginOptions } from '@tanstack/vue-query';
+
+export const vueQueryOptions: VueQueryPluginOptions = {
+  queryClientConfig: {
+    defaultOptions: {
+      queries: {
+        staleTime: 60 * 1000,
+        retry: 1
+      }
+    }
+  }
+};
+`, "utf-8");
+}
+async function wrapReactQueryProvider(targetDir, framework) {
+  if (framework === "nextjs") {
+    await wrapNextjsQueryProvider(targetDir);
+  } else {
+    await wrapReactEntryQueryProvider(targetDir, framework);
+  }
+}
+async function wrapNextjsQueryProvider(targetDir) {
+  const providersPath = join(targetDir, "src/app/providers.tsx");
+  await writeFile(providersPath, `'use client';
+
+import { QueryClientProvider } from '@tanstack/react-query';
+
+import { queryClient } from '@/lib/query-client';
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>;
+}
+`, "utf-8");
+  const layoutPath = join(targetDir, "src/app/layout.tsx");
+  try {
+    let content = await readFile(layoutPath, "utf-8");
+    if (!content.includes("Providers")) {
+      content = content.replace(
+        /^(import\s.*\n)+/m,
+        (match) => `${match}import { Providers } from './providers';
+`
+      );
+      content = content.replace(
+        /\{children\}/,
+        "<Providers>{children}</Providers>"
+      );
+      await writeFile(layoutPath, content, "utf-8");
+    }
+  } catch {
+  }
+}
+async function wrapReactEntryQueryProvider(targetDir, framework) {
+  const mainPath = join(targetDir, "src/main.tsx");
+  try {
+    let content = await readFile(mainPath, "utf-8");
+    if (content.includes("QueryClientProvider")) return;
+    content = content.replace(
+      /^(import\s.*\n)+/m,
+      (match) => `${match}import { QueryClientProvider } from '@tanstack/react-query';
+import { queryClient } from './lib/query-client';
+`
+    );
+    if (framework === "electron") {
+      content = content.replace(
+        /(<BrowserRouter>)/,
+        "<QueryClientProvider client={queryClient}>\n      $1"
+      );
+      content = content.replace(
+        /(<\/BrowserRouter>)/,
+        "$1\n    </QueryClientProvider>"
+      );
+    } else {
+      content = content.replace(
+        /(<App\s*\/>)/,
+        "<QueryClientProvider client={queryClient}>\n      $1\n    </QueryClientProvider>"
+      );
+    }
+    await writeFile(mainPath, content, "utf-8");
+  } catch {
+  }
+}
+async function wrapVueQueryPlugin(targetDir) {
+  const mainPath = join(targetDir, "src/main.ts");
+  try {
+    let content = await readFile(mainPath, "utf-8");
+    if (content.includes("VueQueryPlugin")) return;
+    content = content.replace(
+      /^(import\s.*\n)+/m,
+      (match) => `${match}import { VueQueryPlugin } from '@tanstack/vue-query';
+import { vueQueryOptions } from './lib/query-client';
+`
+    );
+    content = content.replace(
+      /app\.use\(router\)/,
+      "app.use(VueQueryPlugin, vueQueryOptions);\napp.use(router)"
+    );
+    await writeFile(mainPath, content, "utf-8");
+  } catch {
+  }
+}
+
+// src/commands/create.ts
+var execAsync2 = promisify(exec);
+function validateConflictingFlags(options) {
+  const frameworkFlags = [
+    options.nextjs,
+    options.react,
+    options.vue,
+    options.electron
+  ].filter(Boolean);
+  if (frameworkFlags.length > 1) {
+    throw new ConflictingFlagsError("--nextjs, --react, --vue, --electron", "(multiple frameworks)");
+  }
+  const uiLibraryFlags = [
+    options.shadcn,
+    options.diceui,
+    options.shadcnVue,
+    options.heroui
+  ].filter(Boolean);
+  if (uiLibraryFlags.length > 1) {
+    throw new ConflictingFlagsError(
+      "--shadcn, --diceui, --shadcn-vue, --heroui",
+      MESSAGES.UI_MULTIPLE_LIBRARIES
+    );
+  }
+  const stateFlags = [
+    options.zustand,
+    options.tanstackQuery,
+    options.tanstackVueQuery
+  ].filter(Boolean);
+  if (stateFlags.length > 1) {
+    throw new ConflictingFlagsError("--zustand, --tanstack-query, --tanstack-vue-query", "(multiple state management options)");
+  }
+  const linterFlags = [
+    options.eslint,
+    options.biome,
+    options.noLinter
+  ].filter(Boolean);
+  if (linterFlags.length > 1) {
+    throw new ConflictingFlagsError("--eslint, --biome, --no-linter", "(multiple linter options)");
+  }
+  const pmFlags = [
+    options.pnpm,
+    options.npm,
+    options.yarn,
+    options.bun
+  ].filter(Boolean);
+  if (pmFlags.length > 1) {
+    throw new ConflictingFlagsError("--pnpm, --npm, --yarn, --bun", "(multiple package managers)");
+  }
+}
+function validateFrameworkUILibrary(framework, uiLibrary) {
+  if (uiLibrary === "none") return;
+  if (!isUILibraryCompatible(framework, uiLibrary)) {
+    throw new ConflictingFlagsError(
+      `--${framework}`,
+      getUILibraryErrorMessage(framework, uiLibrary)
+    );
+  }
+}
+function getFrameworkFromFlags(options) {
+  if (options.nextjs) return "nextjs";
+  if (options.react) return "react";
+  if (options.vue) return "vue";
+  if (options.electron) return "electron";
+  return void 0;
+}
+function getUiLibraryFromFlags(options) {
+  if (options.shadcn) return "shadcn";
+  if (options.diceui) return "diceui";
+  if (options.shadcnVue) return "shadcn-vue";
+  if (options.heroui) return "heroui";
+  return void 0;
+}
+function getLinterFromFlags(options) {
+  if (options.eslint) return "eslint";
+  if (options.biome) return "biome";
+  if (options.noLinter) return "none";
+  return void 0;
+}
+function getPackageManagerFromFlags(options) {
+  if (options.pnpm) return "pnpm";
+  if (options.npm) return "npm";
+  if (options.yarn) return "yarn";
+  if (options.bun) return "bun";
+  return void 0;
+}
+function getStateManagementFromFlags(options) {
+  if (options.zustand) return "zustand";
+  if (options.tanstackQuery) return "tanstack-query";
+  if (options.tanstackVueQuery) return "tanstack-vue-query";
+  return void 0;
+}
+var FRAMEWORKS = [
+  { name: "nextjs", label: "Next.js (App Router)", description: "Next.js 16+, TypeScript, Tailwind v4" },
+  { name: "react", label: "React + Vite", description: "React 19+, Vite, TypeScript, Tailwind v4" },
+  { name: "vue", label: "Vue + Vite", description: "Vue 3.5+, Vite, TypeScript, Tailwind v4" },
+  { name: "electron", label: "Electron + React", description: "Desktop app, React 19+, Vite, Tailwind v4" }
+];
+var UI_LIBRARIES_NEXTJS = [
+  { name: "shadcn", label: "shadcn/ui (Recommended)", description: "Beautifully designed components from shadcn" },
+  { name: "diceui", label: "DiceUI", description: "shadcn/ui + 5 premium components" },
+  { name: "heroui", label: "HeroUI", description: "Modern React UI library" },
+  { name: "none", label: "None (Plain Tailwind)", description: "Just Tailwind CSS, no component library" }
+];
+var UI_LIBRARIES_REACT = [
+  { name: "shadcn", label: "shadcn/ui (Recommended)", description: "Beautifully designed components from shadcn" },
+  { name: "diceui", label: "DiceUI", description: "shadcn/ui + 5 premium components" },
+  { name: "heroui", label: "HeroUI", description: "Modern React UI library" },
+  { name: "none", label: "None (Plain Tailwind)", description: "Just Tailwind CSS, no component library" }
+];
+var UI_LIBRARIES_VUE = [{ name: "shadcn-vue", label: "shadcn-vue (Recommended)", description: "Vue port of shadcn/ui" }, { name: "none", label: "None (Plain Tailwind)", description: "Just Tailwind CSS, no component library" }];
+var UI_LIBRARIES_ELECTRON = [
+  { name: "shadcn", label: "shadcn/ui", description: "Beautifully designed components from shadcn" },
+  { name: "diceui", label: "DiceUI", description: "shadcn/ui + 5 premium components" },
+  { name: "none", label: "None (Plain Tailwind)", description: "Just Tailwind CSS, no component library" }
+];
+function getUiLibrariesForFramework(framework) {
+  switch (framework) {
+    case "nextjs":
+      return UI_LIBRARIES_NEXTJS;
+    case "react":
+      return UI_LIBRARIES_REACT;
+    case "vue":
+      return UI_LIBRARIES_VUE;
+    case "electron":
+      return UI_LIBRARIES_ELECTRON;
+    default:
+      return UI_LIBRARIES_REACT;
+  }
+}
+var STATE_MGMT_REACT = [
+  { name: "zustand", label: "Zustand (Recommended)", description: "Lightweight client state" },
+  { name: "tanstack-query", label: "TanStack Query", description: "Server state & data fetching" },
+  { name: "none", label: "None", description: "No state management" }
+];
+var STATE_MGMT_VUE = [{ name: "tanstack-vue-query", label: "TanStack Vue Query (Recommended)", description: "Server state & data fetching" }, { name: "none", label: "None", description: "No state management" }];
+function getStateManagementForFramework(framework) {
+  switch (framework) {
+    case "vue":
+      return STATE_MGMT_VUE;
+    default:
+      return STATE_MGMT_REACT;
+  }
+}
+var SHADCN_STYLE_CHOICES = [
+  { name: "vega", label: "Vega (Recommended)", description: "Classic shadcn/ui design" },
+  { name: "nova", label: "Nova", description: "Compact layouts" },
+  { name: "maia", label: "Maia", description: "Soft and rounded" },
+  { name: "lyra", label: "Lyra", description: "Boxy and sharp" },
+  { name: "mira", label: "Mira", description: "Dense interfaces" }
+];
+var SHADCN_BASE_COLOR_CHOICES = [
+  { name: "zinc", label: "Zinc (Default)", description: "Cool neutral gray" },
+  { name: "slate", label: "Slate", description: "Blue-tinted gray" },
+  { name: "neutral", label: "Neutral", description: "Pure gray" },
+  { name: "stone", label: "Stone", description: "Warm gray" },
+  { name: "gray", label: "Gray", description: "Balanced gray" }
+];
+var LINTERS = [
+  { name: "eslint", label: "ESLint (Recommended)", description: "Industry standard, widely supported" },
+  { name: "biome", label: "Biome", description: "Fast, all-in-one linter and formatter" },
+  { name: "none", label: "None", description: "No linter, configure your own later" }
+];
+var PACKAGE_MANAGERS = [
+  { name: "pnpm", label: "pnpm (Recommended)", description: "Fast, disk space efficient" },
+  { name: "npm", label: "npm", description: "Node.js default package manager" },
+  { name: "yarn", label: "yarn", description: "Fast, reliable, and secure" },
+  { name: "bun", label: "bun", description: "All-in-one JavaScript runtime" }
+];
+var TEMPLATE_REPO_BASE = "Docyrus/docyrus-devkit/packages/cli-templates";
+function getTemplateRepo(framework) {
+  return `${TEMPLATE_REPO_BASE}/${framework}`;
+}
+async function directoryExists(path) {
+  try {
+    await access(path, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function registerCreateCommand(program2) {
+  program2.command("create [name]").description("Create a new Docyrus project from template").option("-p, --path <path>", "Target directory path").option("--nextjs", "Use Next.js framework").option("--react", "Use React + Vite framework").option("--vue", "Use Vue + Vite framework").option("--electron", "Use Electron + React framework (desktop app)").option("--shadcn", "Use shadcn/ui (Next.js, React, Electron)").option("--diceui", "Use DiceUI (Next.js, React, Electron)").option("--shadcn-vue", "Use shadcn-vue (Vue)").option("--heroui", "Use HeroUI (Next.js, React)").option("--zustand", "Use Zustand for state management (React, Next.js, Electron)").option("--tanstack-query", "Use TanStack Query for state management (React, Next.js, Electron)").option("--tanstack-vue-query", "Use TanStack Vue Query for state management (Vue)").option("--base-color <color>", "Base color theme for shadcn (zinc, slate, neutral, stone, gray)").option("--eslint", "Use ESLint for linting").option("--biome", "Use Biome for linting").option("--no-linter", "Skip linter configuration").option("--alias <prefix>", "Custom import alias prefix (must start with @)").option("--pnpm", "Use pnpm package manager").option("--npm", "Use npm package manager").option("--yarn", "Use yarn package manager").option("--bun", "Use bun package manager").option("--local", "Use local templates instead of downloading from GitHub (development only)").addHelpText("after", `
+UI Library Compatibility:
+  Next.js   \u2192 shadcn, diceui, heroui
+  React     \u2192 shadcn, diceui, heroui
+  Vue       \u2192 shadcn-vue
+  Electron  \u2192 shadcn, diceui
+
+State Management:
+  React / Next.js / Electron \u2192 zustand, tanstack-query
+  Vue                        \u2192 tanstack-vue-query
+
+Examples:
+  $ docyrus create my-app                                  Interactive mode
+  $ docyrus create my-app --nextjs                         Next.js + plain Tailwind
+  $ docyrus create my-app --nextjs --shadcn                Next.js + shadcn/ui
+  $ docyrus create my-app --react --shadcn --zustand       React + shadcn + Zustand
+  $ docyrus create my-app --react --tanstack-query         React + TanStack Query
+  $ docyrus create my-app --vue --shadcn-vue               Vue + shadcn-vue
+  $ docyrus create my-app --vue --tanstack-vue-query       Vue + TanStack Vue Query
+  $ docyrus create my-app --electron --shadcn --zustand    Electron + shadcn + Zustand
+`).action(async (name, options) => {
+    const accessToken = await requireAuth();
+    if (options) {
+      validateConflictingFlags(options);
+    }
+    const frameworkFromFlags = options ? getFrameworkFromFlags(options) : void 0;
+    const uiLibraryFromFlags = options ? getUiLibraryFromFlags(options) : void 0;
+    const linterFromFlags = options ? getLinterFromFlags(options) : void 0;
+    const packageManagerFromFlags = options ? getPackageManagerFromFlags(options) : void 0;
+    const aliasFromFlags = options?.alias;
+    const framework = frameworkFromFlags ?? await select({
+      message: MESSAGES.CREATE_SELECT_FRAMEWORK,
+      choices: FRAMEWORKS.map((f) => ({
+        name: f.label,
+        value: f.name
+      }))
+    });
+    let uiLibrary;
+    const availableUiLibraries = getUiLibrariesForFramework(framework);
+    if (uiLibraryFromFlags) {
+      validateFrameworkUILibrary(framework, uiLibraryFromFlags);
+      uiLibrary = uiLibraryFromFlags;
+    } else if (frameworkFromFlags) {
+      uiLibrary = "none";
+    } else {
+      uiLibrary = await select({
+        message: MESSAGES.CREATE_SELECT_UI_LIBRARY,
+        choices: availableUiLibraries.map((u) => ({
+          name: u.label,
+          value: u.name
+        }))
+      });
+    }
+    let shadcnStyle = "vega";
+    let baseColor = "zinc";
+    if (uiLibrary === "shadcn" || uiLibrary === "diceui") {
+      if (!frameworkFromFlags) {
+        shadcnStyle = await select({
+          message: "Select component style:",
+          choices: SHADCN_STYLE_CHOICES.map((c) => ({
+            name: c.label,
+            value: c.name,
+            description: c.description
+          }))
+        });
+        baseColor = await select({
+          message: "Select base color:",
+          choices: SHADCN_BASE_COLOR_CHOICES.map((c) => ({
+            name: c.label,
+            value: c.name,
+            description: c.description
+          }))
+        });
+      } else {
+        const validColors = SHADCN_BASE_COLORS;
+        if (options?.baseColor) {
+          if (!validColors.includes(options.baseColor)) {
+            throw new ConflictingFlagsError("--base-color", `must be one of: ${validColors.join(", ")}`);
+          }
+          baseColor = options.baseColor;
+        }
+      }
+    }
+    const stateManagementFromFlags = options ? getStateManagementFromFlags(options) : void 0;
+    const stateMgmtChoices = getStateManagementForFramework(framework);
+    let stateManagement = "none";
+    if (stateMgmtChoices) {
+      if (stateManagementFromFlags) {
+        const compatible = getCompatibleStateManagement(framework);
+        if (!compatible.includes(stateManagementFromFlags)) {
+          throw new ConflictingFlagsError(
+            `--${stateManagementFromFlags}`,
+            `not compatible with ${framework}`
+          );
+        }
+        stateManagement = stateManagementFromFlags;
+      } else if (!frameworkFromFlags) {
+        stateManagement = await select({
+          message: MESSAGES.CREATE_SELECT_STATE_MANAGEMENT,
+          choices: stateMgmtChoices.map((s) => ({
+            name: s.label,
+            value: s.name,
+            description: s.description
+          }))
+        });
+      }
+    }
+    const linter = linterFromFlags ?? await select({
+      message: MESSAGES.CREATE_SELECT_LINTER,
+      choices: LINTERS.map((l) => ({
+        name: l.label,
+        value: l.name
+      }))
+    });
+    let projectName = name;
+    if (!projectName) {
+      projectName = await input({
+        message: MESSAGES.CREATE_PROJECT_NAME,
+        default: `my-${framework}-app`,
+        validate: (value) => {
+          if (!value.trim()) return "Project name is required";
+          if (!/^[a-z0-9-]+$/.test(value)) return "Only lowercase letters, numbers and hyphens allowed";
+          return true;
+        }
+      });
+    }
+    let aliasPrefix = "@";
+    if (aliasFromFlags) {
+      if (!aliasFromFlags.startsWith("@")) {
+        throw new ConflictingFlagsError("--alias", "value must start with @");
+      }
+      if (!/^@[a-zA-Z0-9]*$/.test(aliasFromFlags)) {
+        throw new ConflictingFlagsError("--alias", "only @, @app, @src format allowed");
+      }
+      aliasPrefix = aliasFromFlags;
+    } else {
+      const customizeAlias = await select({
+        message: MESSAGES.CREATE_CUSTOMIZE_ALIAS,
+        choices: [{ name: "No, use @/ (Recommended)", value: false }, { name: "Yes, customize", value: true }]
+      });
+      if (customizeAlias) {
+        aliasPrefix = await input({
+          message: MESSAGES.CREATE_CUSTOM_ALIAS,
+          default: "@",
+          validate: (value) => {
+            if (!value.trim()) return "Alias prefix is required";
+            if (!value.startsWith("@")) return "Alias must start with @";
+            if (!/^@[a-zA-Z0-9]*$/.test(value)) return "Only @, @app, @src format allowed";
+            return true;
+          }
+        });
+      }
+    }
+    const packageManager = packageManagerFromFlags ?? await select({
+      message: MESSAGES.CREATE_SELECT_PACKAGE_MANAGER,
+      choices: PACKAGE_MANAGERS.map((pm) => ({
+        name: pm.label,
+        value: pm.name
+      }))
+    });
+    const targetDir = options?.path ? join(options.path, projectName) : projectName;
+    if (await directoryExists(targetDir)) {
+      throw new ProjectExistsError(projectName);
+    }
+    const isLocalMode = options?.local === true;
+    const templateRepo = getTemplateRepo(framework);
+    logger.newline();
+    logger.log(MESSAGES.CREATE_SETTING_UP);
+    logger.newline();
+    if (isLocalMode) {
+      await withSpinner(
+        MESSAGES.CREATE_COPYING_LOCAL,
+        async () => {
+          const cliPackageDir = dirname(dirname(fileURLToPath(import.meta.url)));
+          const localTemplateDir = resolve(cliPackageDir, "..", "cli-templates", framework);
+          try {
+            await access(localTemplateDir, constants.F_OK);
+          } catch {
+            throw new TemplateError(
+              `Local template not found at: ${localTemplateDir}
+--local requires running from the monorepo development environment.`
+            );
+          }
+          await cp(localTemplateDir, targetDir, { recursive: true });
+          const pkgJsonPath = join(targetDir, "package.json");
+          const pkgJson = JSON.parse(await readFile(pkgJsonPath, "utf-8"));
+          const packagesDir = resolve(cliPackageDir, "..");
+          for (const depType of ["dependencies", "devDependencies"]) {
+            const deps = pkgJson[depType];
+            if (!deps) continue;
+            for (const [name2, version] of Object.entries(deps)) {
+              if (name2.startsWith("@docyrus/") && version === "latest") {
+                const pkgName = name2.replace("@docyrus/", "");
+                const localPkgDir = resolve(packagesDir, pkgName);
+                try {
+                  await access(localPkgDir, constants.F_OK);
+                  deps[name2] = `file:${localPkgDir}`;
+                } catch {
+                  logger.warn(`Local package not found for ${name2}, keeping "latest"`);
+                }
+              }
+            }
+          }
+          await writeFile(pkgJsonPath, `${JSON.stringify(pkgJson, null, 2)}
+`);
+        }
+      );
+    } else {
+      const tokenManager = getTokenManager();
+      let githubToken = await tokenManager.getGithubToken();
+      if (!githubToken) {
+        logger.log(MESSAGES.DOCYRUS_TOKEN_REQUIRED);
+        githubToken = await password({
+          message: MESSAGES.DOCYRUS_TOKEN_PROMPT,
+          mask: "*"
+        });
+        await tokenManager.setGithubToken(githubToken);
+        logger.success(MESSAGES.DOCYRUS_TOKEN_SAVED);
+      }
+      await withSpinner(
+        MESSAGES.CREATE_DOWNLOADING,
+        async () => {
+          const gigetCachePath = resolve(homedir(), ".cache/giget/gh/Docyrus-docyrus-devkit");
+          if (existsSync(gigetCachePath)) {
+            await rm(gigetCachePath, { recursive: true, force: true });
+          }
+          try {
+            await downloadTemplate(`gh:${templateRepo}`, {
+              dir: targetDir,
+              install: false,
+              auth: githubToken
+            });
+          } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            if (errorMessage.includes("401") || errorMessage.includes("403")) {
+              await tokenManager.setGithubToken("");
+              throw new TemplateError(
+                `${MESSAGES.DOCYRUS_TOKEN_INVALID}
+${errorMessage}`
+              );
+            }
+            if (errorMessage.includes("404")) {
+              throw new TemplateError(
+                `Template repository not found or token lacks access.
+Ensure your Docyrus token has correct permissions.
+${errorMessage}`
+              );
+            }
+            throw new TemplateError(`Failed to download template: ${errorMessage}`);
+          }
+          try {
+            await access(join(targetDir, "package.json"), constants.F_OK);
+          } catch {
+            throw new TemplateError(
+              "Template download failed \u2014 no files were downloaded.\nThis usually means your Docyrus token is expired or invalid.\nRun: docyrus config --token"
+            );
+          }
+        }
+      );
+    }
+    if (aliasPrefix !== "@" && aliasPrefix !== "@/") {
+      await withSpinner(
+        MESSAGES.CREATE_CONFIGURING_ALIAS(aliasPrefix),
+        async () => {
+          await applyAliasConfig(targetDir, framework, aliasPrefix);
+        }
+      );
+    }
+    if (linter !== "none") {
+      logger.newline();
+      logger.log(MESSAGES.LINTER_SETUP_TITLE);
+      const linterProgress = createSimpleProgress();
+      try {
+        await applyLinterConfig(targetDir, framework, linter, linterProgress);
+      } catch (error) {
+        throw new TemplateError(
+          `Failed to configure linter: ${error instanceof Error ? error.message : "Unknown error"}`
+        );
+      }
+    }
+    if (stateManagement !== "none") {
+      logger.newline();
+      logger.log(MESSAGES.STATE_MANAGEMENT_SETUP_TITLE);
+      const stateProgress = createSimpleProgress();
+      try {
+        await setupStateManagement(
+          targetDir,
+          framework,
+          stateManagement,
+          stateProgress
+        );
+      } catch (error) {
+        throw new TemplateError(
+          `Failed to setup state management: ${error instanceof Error ? error.message : "Unknown error"}`
+        );
+      }
+    }
+    await withSpinner(
+      MESSAGES.CREATE_INSTALLING,
+      async () => {
+        try {
+          await execAsync2(`${packageManager} install`, { cwd: targetDir });
+        } catch (error) {
+          throw new TemplateError(
+            `Failed to install dependencies: ${error instanceof Error ? error.message : "Unknown error"}`
+          );
+        }
+      }
+    );
+    if (uiLibrary !== "none") {
+      logger.newline();
+      logger.log(MESSAGES.UI_SETUP_TITLE);
+      const progressCallback = createSimpleProgress();
+      try {
+        await setupUILibrary(
+          targetDir,
+          framework,
+          uiLibrary,
+          packageManager,
+          progressCallback,
+          shadcnStyle,
+          baseColor
+        );
+      } catch (error) {
+        throw new TemplateError(
+          `Failed to setup UI library: ${error instanceof Error ? error.message : "Unknown error"}`
+        );
+      }
+    }
+    await withSpinner(
+      "Applying page variants...",
+      async () => applyUIVariants(targetDir, uiLibrary)
+    );
+    logger.newline();
+    logger.log(MESSAGES.OPENAPI_SETUP_TITLE);
+    try {
+      const savedPath = await withSpinner(
+        "Downloading OpenAPI spec...",
+        async () => downloadOpenApiSpec(accessToken, targetDir, "openapi-spec.json"),
+        { successText: "OpenAPI spec downloaded" }
+      );
+      logger.dim(MESSAGES.CREATE_OPENAPI_SUCCESS(savedPath));
+    } catch (error) {
+      logger.warn(`Failed to download OpenAPI spec: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    logger.newline();
+    logger.success(MESSAGES.CREATE_SUCCESS);
+    logger.newline();
+    logger.log(`  cd ${projectName}`);
+    logger.log(`  ${packageManager} run dev`);
+    logger.newline();
+    logger.dim(MESSAGES.API_CLIENT_DOCS);
+  });
+}
+function registerGenerateCommand(program2) {
+  const generate = program2.command("generate").description("Code generation commands");
+  generate.command("api-spec").description("Download OpenAPI specification from Docyrus API").option("-o, --output <path>", "Output file path", "openapi.json").action(async (options) => {
+    const token = await requireAuth();
+    const outputPath = resolve(options.output);
+    if (!output.isJson()) {
+      logger.info("Downloading OpenAPI specification...");
+    }
+    try {
+      const savedPath = await withSpinner(
+        "Fetching OpenAPI spec from API...",
+        async () => downloadOpenApiSpec(token, dirname(outputPath), outputPath.split("/").pop()),
+        { silent: output.isJson() }
+      );
+      output.success("OpenAPI specification downloaded!", { path: savedPath });
+      if (!output.isJson()) {
+        logger.dim(`Saved to: ${savedPath}`);
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      output.error(`Failed to download OpenAPI spec: ${message}`);
+      process.exit(1);
+    }
+  });
+  generate.command("db").description("Generate TanStack Query collections from OpenAPI spec").argument("[spec]", "Path to OpenAPI specification file (JSON)").option("-o, --output <dir>", "Output directory (defaults to src in same folder as spec)").option("-w, --watch", "Watch for changes in the spec file").action(async (specPath, options) => {
+    const resolvedPath = findSpecFile(specPath);
+    if (!resolvedPath) {
+      output.error("OpenAPI spec file not found.");
+      if (!output.isJson()) {
+        logger.dim("Provide a path: docyrus generate db <spec-file>");
+        logger.dim("Or create one of: openapi.json, api.json, spec.json");
+      }
+      process.exit(1);
+    }
+    if (!existsSync(resolvedPath)) {
+      output.error(`OpenAPI spec file not found: ${resolvedPath}`);
+      process.exit(1);
+    }
+    const outputDir = options.output || join(dirname(resolvedPath), "src");
+    if (!output.isJson()) {
+      logger.info("TanStack DB Generator");
+      logger.dim(`  Spec: ${resolvedPath}`);
+      logger.dim(`  Output: ${outputDir}`);
+      logger.newline();
+    }
+    try {
+      const specContent = readFileSync(resolvedPath, "utf-8");
+      const spec = JSON.parse(specContent);
+      await withSpinner(
+        "Generating TanStack Query collections...",
+        async () => {
+          await generateFromOpenAPI(spec, outputDir);
+        },
+        {
+          silent: output.isJson(),
+          successText: "Generation completed!"
+        }
+      );
+      output.success("TanStack Query collections generated successfully!", {
+        spec: resolvedPath,
+        output: outputDir
+      });
+      if (options.watch) {
+        if (!output.isJson()) {
+          logger.info("Watch mode is not yet implemented.");
+        }
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      output.error(`Generation failed: ${message}`);
+      process.exit(1);
+    }
+  });
+}
+function findSpecFile(specPath) {
+  if (specPath) {
+    return resolve(specPath);
+  }
+  const defaultSpec = resolve("openapi.json");
+  if (existsSync(defaultSpec)) {
+    return defaultSpec;
+  }
+  return null;
+}
+var execAsync3 = promisify(exec);
+async function getLatestVersion() {
+  try {
+    const response = await fetch(`https://registry.npmjs.org/${NPM_PACKAGE_NAME}`);
+    if (!response.ok) return null;
+    const data = await response.json();
+    return data["dist-tags"]?.latest || null;
+  } catch {
+    return null;
+  }
+}
+function isNewerVersion(current, latest) {
+  const currentParts = current.replace(/^v/, "").split(".").map(Number);
+  const latestParts = latest.replace(/^v/, "").split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const curr = currentParts[i] || 0;
+    const lat = latestParts[i] || 0;
+    if (lat > curr) return true;
+    if (lat < curr) return false;
+  }
+  return false;
+}
+async function detectPackageManager() {
+  const npmExecpath = process.env.npm_execpath || "";
+  if (npmExecpath.includes("pnpm")) return "pnpm";
+  if (npmExecpath.includes("yarn")) return "yarn";
+  if (npmExecpath.includes("bun")) return "bun";
+  try {
+    await execAsync3("pnpm --version");
+    return "pnpm";
+  } catch {
+  }
+  try {
+    await execAsync3("yarn --version");
+    return "yarn";
+  } catch {
+  }
+  return "npm";
+}
+function registerUpgradeCommand(program2) {
+  program2.command("upgrade").description("Upgrade Docyrus CLI to the latest version").action(async () => {
+    const latestVersion = await withSpinner(
+      "Checking for updates...",
+      getLatestVersion,
+      { silent: output.isJson() }
+    );
+    if (!latestVersion) {
+      output.error("Failed to check for updates. Please try again later.");
+      process.exit(1);
+    }
+    if (!isNewerVersion(CLI_VERSION, latestVersion)) {
+      output.success(`You're already on the latest version (${CLI_VERSION})`);
+      return;
+    }
+    if (!output.isJson()) {
+      logger.info(`New version available: ${CLI_VERSION} \u2192 ${latestVersion}`);
+      logger.newline();
+    }
+    const pm = await detectPackageManager();
+    const commands = {
+      npm: `npm install -g ${NPM_PACKAGE_NAME}@latest`,
+      pnpm: `pnpm add -g ${NPM_PACKAGE_NAME}@latest`,
+      yarn: `yarn global add ${NPM_PACKAGE_NAME}@latest`,
+      bun: `bun add -g ${NPM_PACKAGE_NAME}@latest`
+    };
+    const command = commands[pm];
+    try {
+      await withSpinner(
+        `Upgrading via ${pm}...`,
+        async () => {
+          await execAsync3(command);
+        },
+        {
+          silent: output.isJson(),
+          successText: "Upgrade completed!"
+        }
+      );
+      output.success(`Successfully upgraded to v${latestVersion}`, {
+        previousVersion: CLI_VERSION,
+        newVersion: latestVersion,
+        packageManager: pm
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      output.error(`Upgrade failed: ${message}`);
+      if (!output.isJson()) {
+        logger.dim(`Try manually: ${command}`);
+      }
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/completion.ts
+var BASH_COMPLETION = `
+###-begin-${CLI_NAME}-completions-###
+_${CLI_NAME}_completions() {
+  local cur_word args type_list
+  cur_word="\${COMP_WORDS[COMP_CWORD]}"
+  args=("\${COMP_WORDS[@]}")
+
+  # Commands
+  type_list="login logout whoami create generate upgrade completion info help"
+
+  # Subcommands for generate
+  if [[ \${args[1]} == "generate" ]]; then
+    type_list="db"
+  fi
+
+  COMPREPLY=($(compgen -W "\${type_list}" -- \${cur_word}))
+  return 0
+}
+complete -F _${CLI_NAME}_completions ${CLI_NAME}
+###-end-${CLI_NAME}-completions-###
+`.trim();
+var ZSH_COMPLETION = `
+###-begin-${CLI_NAME}-completions-###
+_${CLI_NAME}() {
+  local -a commands
+  commands=(
+    'login:Log in to Docyrus'
+    'logout:Log out from Docyrus'
+    'whoami:Display the current logged-in user'
+    'create:Create a new Docyrus project from template'
+    'generate:Code generation commands'
+    'upgrade:Upgrade Docyrus CLI to the latest version'
+    'completion:Generate shell completion script'
+    'info:Display CLI and environment information'
+    'help:Display help for command'
+  )
+
+  local -a generate_commands
+  generate_commands=(
+    'db:Generate TanStack Query collections from OpenAPI spec'
+  )
+
+  _arguments -C \\
+    '1: :->command' \\
+    '*::arg:->args'
+
+  case "$state" in
+    command)
+      _describe 'command' commands
+      ;;
+    args)
+      case $words[1] in
+        generate)
+          _describe 'subcommand' generate_commands
+          ;;
+      esac
+      ;;
+  esac
+}
+compdef _${CLI_NAME} ${CLI_NAME}
+###-end-${CLI_NAME}-completions-###
+`.trim();
+var FISH_COMPLETION = `
+###-begin-${CLI_NAME}-completions-###
+complete -c ${CLI_NAME} -f
+
+# Commands
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "login" -d "Log in to Docyrus"
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "logout" -d "Log out from Docyrus"
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "whoami" -d "Display the current logged-in user"
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "create" -d "Create a new Docyrus project"
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "generate" -d "Code generation commands"
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "upgrade" -d "Upgrade Docyrus CLI"
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "completion" -d "Generate shell completion"
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "info" -d "Display CLI and environment information"
+complete -c ${CLI_NAME} -n "__fish_use_subcommand" -a "help" -d "Display help"
+
+# generate subcommands
+complete -c ${CLI_NAME} -n "__fish_seen_subcommand_from generate" -a "db" -d "Generate TanStack Query collections"
+###-end-${CLI_NAME}-completions-###
+`.trim();
+function registerCompletionCommand(program2) {
+  program2.command("completion").description("Generate shell completion script").argument("<shell>", "Shell type: bash, zsh, or fish").action((shell) => {
+    const shellLower = shell.toLowerCase();
+    let script;
+    let instructions;
+    switch (shellLower) {
+      case "bash":
+        script = BASH_COMPLETION;
+        instructions = `Add to ~/.bashrc:
+  eval "$(${CLI_NAME} completion bash)"`;
+        break;
+      case "zsh":
+        script = ZSH_COMPLETION;
+        instructions = `Add to ~/.zshrc:
+  eval "$(${CLI_NAME} completion zsh)"`;
+        break;
+      case "fish":
+        script = FISH_COMPLETION;
+        instructions = `Save to ~/.config/fish/completions/${CLI_NAME}.fish:
+  ${CLI_NAME} completion fish > ~/.config/fish/completions/${CLI_NAME}.fish`;
+        break;
+      default:
+        output.error(`Unknown shell: ${shell}`);
+        if (!output.isJson()) {
+          logger.dim("Supported shells: bash, zsh, fish");
+        }
+        process.exit(1);
+    }
+    if (output.isJson()) {
+      output.set("shell", shellLower);
+      output.set("script", script);
+      output.set("instructions", instructions);
+    } else {
+      console.warn(script);
+      logger.dim(instructions);
+    }
+  });
+}
+function registerInfoCommand(program2) {
+  program2.command("info").description("Display CLI and environment information").action(async () => {
+    const tokenManager = getTokenManager();
+    const isLoggedIn = await tokenManager.isLoggedIn();
+    const email = isLoggedIn ? await tokenManager.getUserEmail() : void 0;
+    const info = {
+      cli: {
+        name: CLI_NAME,
+        version: CLI_VERSION
+      },
+      node: {
+        version: process.version
+      },
+      os: {
+        platform: platform(),
+        release: release(),
+        arch: arch()
+      },
+      environment: {
+        apiUrl: DOCYRUS_API_URL,
+        configDir: join(homedir(), ".docyrus")
+      },
+      auth: {
+        loggedIn: isLoggedIn,
+        ...email && { email }
+      }
+    };
+    if (output.isJson()) {
+      output.set("info", info);
+    } else {
+      logger.bold(`${CLI_NAME} v${CLI_VERSION}`);
+      logger.newline();
+      logger.log("System:");
+      logger.dim(`  Node.js:  ${info.node.version}`);
+      logger.dim(`  OS:       ${info.os.platform} ${info.os.release} (${info.os.arch})`);
+      logger.newline();
+      logger.log("Environment:");
+      logger.dim(`  API URL:  ${info.environment.apiUrl}`);
+      logger.dim(`  Config:   ${info.environment.configDir}`);
+      logger.newline();
+      logger.log("Authentication:");
+      if (info.auth.loggedIn) {
+        logger.dim(`  Status:   Logged in`);
+        if (info.auth.email) {
+          logger.dim(`  Email:    ${info.auth.email}`);
+        }
+      } else {
+        logger.dim(`  Status:   Not logged in`);
+      }
+    }
+  });
+}
+function registerConfigCommand(program2) {
+  program2.command("config").description("Manage CLI configuration").option("--token", "Update Docyrus token for private template access").option("--show", "Show current configuration").action(async (options) => {
+    const tokenManager = getTokenManager();
+    if (options.show) {
+      const githubToken2 = await tokenManager.getGithubToken();
+      const isLoggedIn2 = await tokenManager.isLoggedIn();
+      const email2 = await tokenManager.getUserEmail();
+      logger.log("Current configuration:");
+      logger.newline();
+      logger.log(`  Docyrus Login: ${isLoggedIn2 ? `\u2713 ${email2}` : "\u2717 Not logged in"}`);
+      logger.log(`  Docyrus Token: ${githubToken2 ? "\u2713 Configured" : "\u2717 Not configured"}`);
+      logger.newline();
+      return;
+    }
+    if (options.token) {
+      const currentToken = await tokenManager.getGithubToken();
+      if (currentToken) {
+        logger.log("Current Docyrus token will be replaced.");
+      }
+      const newToken = await password({
+        message: MESSAGES.DOCYRUS_TOKEN_PROMPT,
+        mask: "*"
+      });
+      if (newToken) {
+        await tokenManager.setGithubToken(newToken);
+        logger.success(MESSAGES.DOCYRUS_TOKEN_SAVED);
+      } else {
+        logger.warn("No token provided. Token not updated.");
+      }
+      return;
+    }
+    const githubToken = await tokenManager.getGithubToken();
+    const isLoggedIn = await tokenManager.isLoggedIn();
+    const email = await tokenManager.getUserEmail();
+    logger.log("Current configuration:");
+    logger.newline();
+    logger.log(`  Docyrus Login: ${isLoggedIn ? `\u2713 ${email}` : "\u2717 Not logged in"}`);
+    logger.log(`  Docyrus Token: ${githubToken ? "\u2713 Configured" : "\u2717 Not configured"}`);
+    logger.newline();
+    logger.log("To update token: docyrus config --token");
+  });
+}
+
+// src/commands/index.ts
+function registerCommands(program2) {
+  registerLoginCommand(program2);
+  registerLogoutCommand(program2);
+  registerWhoamiCommand(program2);
+  registerCreateCommand(program2);
+  registerGenerateCommand(program2);
+  registerUpgradeCommand(program2);
+  registerCompletionCommand(program2);
+  registerInfoCommand(program2);
+  registerConfigCommand(program2);
+}
+function isNewerVersion2(current, latest) {
+  const currentParts = current.replace(/^v/, "").split(".").map(Number);
+  const latestParts = latest.replace(/^v/, "").split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const curr = currentParts[i] || 0;
+    const lat = latestParts[i] || 0;
+    if (lat > curr) return true;
+    if (lat < curr) return false;
+  }
+  return false;
+}
+async function checkForUpdates(packageName, currentVersion) {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3e3);
+    const response = await fetch(`https://registry.npmjs.org/${packageName}`, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok) return;
+    const data = await response.json();
+    const latestVersion = data["dist-tags"]?.latest;
+    if (latestVersion && isNewerVersion2(currentVersion, latestVersion)) {
+      console.info();
+      console.info(chalk4.yellow("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"));
+      console.info(chalk4.yellow("\u2502") + chalk4.bold("  Update available! ") + chalk4.dim(`${currentVersion} \u2192 `) + chalk4.green(latestVersion) + chalk4.yellow("        \u2502"));
+      console.info(chalk4.yellow("\u2502") + chalk4.dim(`  Run `) + chalk4.cyan(`npm i -g ${packageName}`) + chalk4.dim(" to update") + chalk4.yellow("   \u2502"));
+      console.info(chalk4.yellow("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));
+      console.info();
+    }
+  } catch {
+  }
+}
+
+// src/cli.ts
+var program = new Command();
+program.name(CLI_NAME).description("Docyrus CLI - Authentication and project management tools").version(CLI_VERSION, "-v, --version", "Display version number").option("--json", "Output results in JSON format").hook("preAction", (thisCommand) => {
+  const opts = thisCommand.opts();
+  if (opts.json) {
+    output.setFormat("json");
+  }
+}).hook("postAction", () => {
+  output.flush();
+});
+registerCommands(program);
+program.configureOutput({
+  outputError: (str, write) => write(str)
+});
+async function main() {
+  try {
+    if (!process.argv.includes("--json")) {
+      checkForUpdates(NPM_PACKAGE_NAME, CLI_VERSION).catch(() => {
+      });
+    }
+    await program.parseAsync(process.argv);
+  } catch (error) {
+    if (error instanceof CliError) {
+      output.error(error.message);
+      if (error.suggestion && !output.isJson()) {
+        logger.dim(error.suggestion);
+      }
+      output.flush();
+      process.exit(error.exitCode);
+    }
+    if (error instanceof Error) {
+      output.error(error.message);
+      if (process.env.DEBUG) {
+        console.error(error.stack);
+      }
+      output.flush();
+      process.exit(1);
+    }
+    output.error("An unexpected error occurred.");
+    output.flush();
+    process.exit(1);
+  }
+}
+main();
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map