@squidcloud/cli 1.0.449 → 1.0.451

package/dist/index.js

@@ -11221,6 +11221,43 @@ const packageJson = __webpack_require__(2108)
 
 const version = packageJson.version
 
+// Array of tips to display randomly
+const TIPS = [
+  '🔐 encrypt with Dotenvx: https://dotenvx.com',
+  '🔐 prevent committing .env to code: https://dotenvx.com/precommit',
+  '🔐 prevent building .env in docker: https://dotenvx.com/prebuild',
+  '🤖 agentic secret storage: https://dotenvx.com/as2',
+  '⚡️ secrets for agents: https://dotenvx.com/as2',
+  '🛡️ auth for agents: https://vestauth.com',
+  '🛠️  run anywhere with `dotenvx run -- yourcommand`',
+  '⚙️  specify custom .env file path with { path: \'/custom/path/.env\' }',
+  '⚙️  enable debug logging with { debug: true }',
+  '⚙️  override existing env vars with { override: true }',
+  '⚙️  suppress all logs with { quiet: true }',
+  '⚙️  write to custom object with { processEnv: myObject }',
+  '⚙️  load multiple .env files with { path: [\'.env.local\', \'.env\'] }'
+]
+
+// Get a random tip from the tips array
+function _getRandomTip () {
+  return TIPS[Math.floor(Math.random() * TIPS.length)]
+}
+
+function parseBoolean (value) {
+  if (typeof value === 'string') {
+    return !['false', '0', 'no', 'off', ''].includes(value.toLowerCase())
+  }
+  return Boolean(value)
+}
+
+function supportsAnsi () {
+  return process.stdout.isTTY // && process.env.TERM !== 'dumb'
+}
+
+function dim (text) {
+  return supportsAnsi() ? `\x1b[2m${text}\x1b[0m` : text
+}
+
 const LINE = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg
 
 // Parse src into an Object
@@ -11306,7 +11343,7 @@ function _parseVault (options) {
 }
 
 function _warn (message) {
-  console.log(`[dotenv@${version}][WARN] ${message}`)
+  console.error(`[dotenv@${version}][WARN] ${message}`)
 }
 
 function _debug (message) {
@@ -11404,8 +11441,8 @@ function _resolveHome (envPath) {
 }
 
 function _configVault (options) {
-  const debug = Boolean(options && options.debug)
-  const quiet = options && 'quiet' in options ? options.quiet : true
+  const debug = parseBoolean(process.env.DOTENV_CONFIG_DEBUG || (options && options.debug))
+  const quiet = parseBoolean(process.env.DOTENV_CONFIG_QUIET || (options && options.quiet))
 
   if (debug || !quiet) {
     _log('Loading env from encrypted .env.vault')
@@ -11426,8 +11463,12 @@ function _configVault (options) {
 function configDotenv (options) {
   const dotenvPath = path.resolve(process.cwd(), '.env')
   let encoding = 'utf8'
-  const debug = Boolean(options && options.debug)
-  const quiet = options && 'quiet' in options ? options.quiet : true
+  let processEnv = process.env
+  if (options && options.processEnv != null) {
+    processEnv = options.processEnv
+  }
+  let debug = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || (options && options.debug))
+  let quiet = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || (options && options.quiet))
 
   if (options && options.encoding) {
     encoding = options.encoding
@@ -11467,15 +11508,14 @@ function configDotenv (options) {
     }
   }
 
-  let processEnv = process.env
-  if (options && options.processEnv != null) {
-    processEnv = options.processEnv
-  }
+  const populated = DotenvModule.populate(processEnv, parsedAll, options)
 
-  DotenvModule.populate(processEnv, parsedAll, options)
+  // handle user settings DOTENV_CONFIG_ options inside .env file(s)
+  debug = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || debug)
+  quiet = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || quiet)
 
   if (debug || !quiet) {
-    const keysCount = Object.keys(parsedAll).length
+    const keysCount = Object.keys(populated).length
     const shortPaths = []
     for (const filePath of optionPaths) {
       try {
@@ -11489,7 +11529,7 @@ function configDotenv (options) {
       }
     }
 
-    _log(`injecting env (${keysCount}) from ${shortPaths.join(',')}`)
+    _log(`injecting env (${keysCount}) from ${shortPaths.join(',')} ${dim(`-- tip: ${_getRandomTip()}`)}`)
   }
 
   if (lastError) {
@@ -11553,6 +11593,7 @@ function decrypt (encrypted, keyStr) {
 function populate (processEnv, parsed, options = {}) {
   const debug = Boolean(options && options.debug)
   const override = Boolean(options && options.override)
+  const populated = {}
 
   if (typeof parsed !== 'object') {
     const err = new Error('OBJECT_REQUIRED: Please check the processEnv argument being passed to populate')
@@ -11565,6 +11606,7 @@ function populate (processEnv, parsed, options = {}) {
     if (Object.prototype.hasOwnProperty.call(processEnv, key)) {
       if (override === true) {
         processEnv[key] = parsed[key]
+        populated[key] = parsed[key]
       }
 
       if (debug) {
@@ -11576,8 +11618,11 @@ function populate (processEnv, parsed, options = {}) {
       }
     } else {
       processEnv[key] = parsed[key]
+      populated[key] = parsed[key]
     }
   }
+
+  return populated
 }
 
 const DotenvModule = {
@@ -29656,6 +29701,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.OPEN_AI_CREATE_SPEECH_FORMATS = exports.AI_AUDIO_CREATE_SPEECH_MODEL_NAMES = exports.AI_AUDIO_TRANSCRIPTION_MODEL_NAMES = exports.AI_IMAGE_MODEL_NAMES = exports.FLUX_MODEL_NAMES = exports.STABLE_DIFFUSION_MODEL_NAMES = exports.OPENAI_AUDIO_MODEL_NAMES = exports.OPENAI_AUDIO_CREATE_SPEECH_MODEL_NAMES = exports.OPENAI_AUDIO_TRANSCRIPTION_MODEL_NAMES = exports.OPENAI_IMAGE_MODEL_NAMES = exports.AI_EMBEDDINGS_MODEL_NAMES = exports.BEDROCK_EMBEDDING_MODEL_NAMES = exports.VOYAGE_EMBEDDING_MODEL_NAMES = exports.OPENAI_EMBEDDINGS_MODEL_NAMES = exports.VENDOR_AI_CHAT_MODEL_NAMES = exports.ANTHROPIC_CHAT_MODEL_NAMES = exports.GROK_CHAT_MODEL_NAMES = exports.GEMINI_CHAT_MODEL_NAMES = exports.OPENAI_CHAT_MODEL_NAMES = exports.AI_PROVIDER_TYPES = exports.RERANK_PROVIDERS = void 0;
 exports.isVendorAiChatModelName = isVendorAiChatModelName;
 exports.isAiEmbeddingsModelName = isAiEmbeddingsModelName;
+exports.isIntegrationEmbeddingModelSpec = isIntegrationEmbeddingModelSpec;
 exports.isIntegrationModelSpec = isIntegrationModelSpec;
 /**
  * @category AI
@@ -29681,7 +29727,7 @@ exports.AI_PROVIDER_TYPES = [
  * Public OpenAI chat model names (active models only).
  * @category AI
  */
-exports.OPENAI_CHAT_MODEL_NAMES = ['gpt-5-mini', 'gpt-5-nano', 'gpt-5.2', 'gpt-5.2-pro'];
+exports.OPENAI_CHAT_MODEL_NAMES = ['gpt-5-mini', 'gpt-5-nano', 'gpt-5.2', 'gpt-5.2-pro', 'gpt-5.4'];
 /**
  * Public Gemini chat model names (active models only).
  * @category AI
@@ -29742,6 +29788,13 @@ exports.AI_EMBEDDINGS_MODEL_NAMES = [
 function isAiEmbeddingsModelName(modelName) {
     return exports.AI_EMBEDDINGS_MODEL_NAMES.includes(modelName);
 }
+/**
+ * Type guard for `IntegrationEmbeddingModelSpec`.
+ * @category AI
+ */
+function isIntegrationEmbeddingModelSpec(model) {
+    return (typeof model === 'object' && model !== null && 'integrationId' in model && 'model' in model && 'dimensions' in model);
+}
 /**
  * The supported AI image generation model names.
  * @category AI
@@ -29893,6 +29946,7 @@ exports.INTEGRATION_TYPES = [
     'legend',
     'teams',
     'openai_compatible',
+    'openai_compatible_embedding',
 ];
 /**
  * @category Database
@@ -30158,6 +30212,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.extractFromBuffer = extractFromBuffer;
 exports.checkFileOrDirExists = checkFileOrDirExists;
 exports.assertFileOrDirExists = assertFileOrDirExists;
+exports.getRuntimeVmLabel = getRuntimeVmLabel;
 const assertic_1 = __webpack_require__(3205);
 const decompress_1 = __importDefault(__webpack_require__(482));
 const fs = __importStar(__webpack_require__(9896));
@@ -30178,6 +30233,14 @@ async function assertFileOrDirExists(path, errorProvider) {
     const exists = await checkFileOrDirExists(path);
     (0, assertic_1.assertTruthy)(exists, errorProvider || `File not exists: ${path}`);
 }
+function getRuntimeVmLabel() {
+    // @ts-expect-error Bun is not defined in Node.js types
+    if (typeof Bun !== 'undefined') {
+        // @ts-expect-error Bun is not defined in Node.js types
+        return `Bun v${Bun.version}`;
+    }
+    return `Node ${process.version}`;
+}
 
 
 /***/ },
@@ -30325,7 +30388,11 @@ function isSquidDebugEnabledByDefault() {
     }
     return param === '1' || param === 'true';
 }
-enableDebugLogs(isSquidDebugEnabledByDefault());
+// Auto-initialize debug flag only if not explicitly set already.
+// This prevents bundled code from overriding the flag set by the host application.
+if (getGlobal()?.['SQUID_LOG_DEBUG_ENABLED'] === undefined) {
+    enableDebugLogs(isSquidDebugEnabledByDefault());
+}
 /** @internal */
 function disableTimestampsInLog() {
     const globalObj = getGlobal();
@@ -30387,14 +30454,12 @@ exports.KOTLIN_CONTROLLERS = [
     'mutation',
     'native-query',
     'observability',
-    'openapi',
     'query',
     'queue',
     'quota',
     'scheduler',
     'secret',
     'storage',
-    'webhooks',
     'ws',
     'internal-extraction',
     'notification',
@@ -30551,6 +30616,7 @@ async function getOpenApiSpecAndControllersFromFile(codeDir) {
  */
 async function populateOpenApiControllersMap(bundleData, codeDir, codeType) {
     const openApiControllersMap = {};
+    const openApiSpecsMap = {};
     const openApiSpecAndControllers = await getOpenApiSpecAndControllersFromFile(codeDir);
     for (const [key, value] of Object.entries(openApiSpecAndControllers.openApiControllersMap)) {
         if (key === 'default' && codeType === 'connector') {
@@ -30559,7 +30625,14 @@ async function populateOpenApiControllersMap(bundleData, codeDir, codeType) {
         }
         openApiControllersMap[key] = JSON.parse(value);
     }
+    for (const [key, value] of Object.entries(openApiSpecAndControllers.openApiSpecsMap)) {
+        if (key === 'default' && codeType === 'connector') {
+            continue;
+        }
+        openApiSpecsMap[key] = value;
+    }
     bundleData.openApiControllersMap = openApiControllersMap;
+    bundleData.openApiSpecsMap = openApiSpecsMap;
 }
 
 
@@ -30866,10 +30939,15 @@ const resolve_1 = __webpack_require__(412);
 const shell_runner_1 = __webpack_require__(3089);
 class TsoaUtils {
     constructor() { }
-    static async generateAllSpecs(verbose = false, supportsDefault = true) {
+    /**
+     * @param projectDir - Root directory of the user's backend project.
+     * @param supportsDefault - Include the default tsoa spec (pass false for connectors).
+     * @param verbose - Log detailed progress and diagnostic messages.
+     */
+    static async generateAllSpecs(projectDir, supportsDefault, verbose) {
         const specsMap = {};
         // Read files in the current directory.
-        let files = await fsPromises.readdir(process.cwd());
+        let files = await fsPromises.readdir(projectDir);
         // Filter files matching the TSOA pattern (e.g. "tsoa.json", "tsoa-myapp.json", "tsoaAnother.json").
         files = files.filter(file => /^tsoa.*\.json$/.test(file));
         // If an exact "tsoa.json" is not present, get the fallback path.
@@ -30877,7 +30955,7 @@ class TsoaUtils {
             const hasAnyTsoaFilesProvidedByUser = files.length > 0;
             const localBackendModule = await (0, resolve_1.findModulePath)('@squidcloud/local-backend');
             if (localBackendModule) {
-                const fallback = path.relative(process.cwd(), path.resolve(localBackendModule, '../../tsoa.json'));
+                const fallback = path.relative(projectDir, path.resolve(localBackendModule, '../../tsoa.json'));
                 if (verbose) {
                     console.log(`"tsoa.json" not found in current directory. Using fallback: ${fallback}`);
                 }
@@ -30888,7 +30966,7 @@ class TsoaUtils {
                 // If this directory contains no '@Route' annotations - there are no tsoa controllers and there is no need to
                 // run tsoa at all.
                 if (!hasAnyTsoaFilesProvidedByUser) {
-                    const hasTsoaAnnotationsInUserCode = await checkUserCodeUsesTsoa(path.resolve(process.cwd(), 'src'));
+                    const hasTsoaAnnotationsInUserCode = await checkUserCodeUsesTsoa(path.resolve(projectDir, 'src'));
                     if (!hasTsoaAnnotationsInUserCode) {
                         if (verbose) {
                             console.log('No TSOA annotations were found in the user code; skipping API generation with TSOA.');
@@ -30915,14 +30993,16 @@ class TsoaUtils {
                 console.log(`Processing config file: ${file}`);
             }
             // Use native join to create the folder.
-            const outputDir = path.join('dist', specName);
-            if (!fs.existsSync(outputDir)) {
-                fs.mkdirSync(outputDir, { recursive: true });
+            // absOutputDir is used for Node fs operations; relOutputDir is passed to tsoa (which runs in projectDir).
+            const relOutputDir = path.join('dist', specName);
+            const absOutputDir = path.resolve(projectDir, relOutputDir);
+            if (!fs.existsSync(absOutputDir)) {
+                fs.mkdirSync(absOutputDir, { recursive: true });
             }
             // Read the original TSOA config.
             let configContent;
             try {
-                configContent = await fsPromises.readFile(file, { encoding: 'utf8' });
+                configContent = await fsPromises.readFile(path.resolve(projectDir, file), { encoding: 'utf8' });
             }
             catch (e) {
                 if (verbose) {
@@ -30941,10 +31021,11 @@ class TsoaUtils {
                 throw e;
             }
             // Override the output directories for both spec and routes.
+            // Use relative paths so tsoa (running in projectDir) resolves them correctly.
             config.spec = config.spec || {};
             config.routes = config.routes || {};
-            config.spec.outputDirectory = outputDir;
-            config.routes.routesDir = outputDir;
+            config.spec.outputDirectory = relOutputDir;
+            config.routes.routesDir = relOutputDir;
             // Fix middlewareTemplate path when using fallback from local-backend
             if (config.routes.middlewareTemplate && !path.isAbsolute(file)) {
                 const localBackendModule = await (0, resolve_1.findModulePath)('@squidcloud/local-backend');
@@ -30966,7 +31047,7 @@ class TsoaUtils {
                         // Rewrite the middlewareTemplate path to be relative to the current working directory.
                         const templatePath = path.resolve(packageRoot, 'dist/local-backend/openapi-template.hbs');
                         // Calculate relative path from current working directory (which might be backend/ or test-tsoa/backend/)
-                        config.routes.middlewareTemplate = path.relative(process.cwd(), templatePath);
+                        config.routes.middlewareTemplate = path.relative(projectDir, templatePath);
                         if (verbose) {
                             console.log(`Rewritten middlewareTemplate path to: ${config.routes.middlewareTemplate}`);
                             console.log(`Template absolute path: ${templatePath}`);
@@ -30975,27 +31056,28 @@ class TsoaUtils {
                     }
                 }
             }
-            // Use a relative path for the temporary config file.
-            const tempConfigPath = `temp-tsoa-config-${specName}.json`;
+            // Use a relative name for the tsoa command (tsoa runs in projectDir) and absolute path for Node fs operations.
+            const tempConfigName = `temp-tsoa-config-${specName}.json`;
+            const absTempConfigPath = path.resolve(projectDir, tempConfigName);
             try {
-                await fsPromises.writeFile(tempConfigPath, JSON.stringify(config, null, 2), { encoding: 'utf8' });
+                await fsPromises.writeFile(absTempConfigPath, JSON.stringify(config, null, 2), { encoding: 'utf8' });
             }
             catch (e) {
                 if (verbose) {
-                    console.error(`Error writing temporary config file ${tempConfigPath}:`, e);
+                    console.error(`Error writing temporary config file ${absTempConfigPath}:`, e);
                 }
                 throw e;
             }
             // Build the TSOA commands (without using -o) that reference the temporary config.
-            const specCmd = `npx tsoa spec -c ${tempConfigPath}`;
-            const routesCmd = `npx tsoa routes -c ${tempConfigPath}`;
+            const specCmd = `npx tsoa spec -c ${tempConfigName}`;
+            const routesCmd = `npx tsoa routes -c ${tempConfigName}`;
             if (verbose) {
-                console.log(`Processing ${file} as "${specName}" with temporary config ${tempConfigPath}`);
+                console.log(`Processing ${file} as "${specName}" with temporary config ${tempConfigName}`);
                 console.log(`Running: ${specCmd}`);
                 console.log(`Running: ${routesCmd}`);
             }
             try {
-                await Promise.all([(0, shell_runner_1.runInShell)(specCmd, false, process.cwd()), (0, shell_runner_1.runInShell)(routesCmd, false, process.cwd())]);
+                await Promise.all([(0, shell_runner_1.runInShell)(specCmd, false, projectDir), (0, shell_runner_1.runInShell)(routesCmd, false, projectDir)]);
             }
             catch (e) {
                 const combinedOutput = e?.combinedOutput;
@@ -31005,18 +31087,18 @@ class TsoaUtils {
                         console.log(`No controllers found for ${file}, skipping...`);
                     }
                     // Clean up the temporary config file before continuing.
-                    await fsPromises.unlink(tempConfigPath);
+                    await fsPromises.unlink(absTempConfigPath);
                     continue;
                 }
                 if (verbose) {
                     console.error(`Error processing ${file}:\n`, errorMessage);
                 }
-                await fsPromises.unlink(tempConfigPath);
+                await fsPromises.unlink(absTempConfigPath);
                 throw new Error(`Failed to process ${file}: ` + errorMessage);
             }
-            // Define output file paths.
-            const swaggerOutput = path.join(outputDir, 'swagger.json');
-            const routesOutput = path.join(outputDir, 'routes.ts');
+            // Define output file paths using absolute paths for Node fs operations.
+            const swaggerOutput = path.join(absOutputDir, 'swagger.json');
+            const routesOutput = path.join(absOutputDir, 'routes.ts');
             try {
                 const swaggerContent = await fsPromises.readFile(swaggerOutput, { encoding: 'utf8' });
                 const modifiedSwaggerContent = await TsoaUtils.attachCodeSamples(swaggerContent);
@@ -31030,11 +31112,11 @@ class TsoaUtils {
                 if (verbose) {
                     console.error(`Error reading generated files for ${file}:`, e);
                 }
-                await fsPromises.unlink(tempConfigPath);
+                await fsPromises.unlink(absTempConfigPath);
                 throw e;
             }
             // Clean up the temporary config file.
-            await fsPromises.unlink(tempConfigPath);
+            await fsPromises.unlink(absTempConfigPath);
         }
         const openApiControllersMap = {};
         const openApiSpecsMap = {};
@@ -31236,6 +31318,7 @@ const process_env_utils_1 = __webpack_require__(9360);
 const resolve_1 = __webpack_require__(412);
 const tsoa_utils_1 = __webpack_require__(1431);
 const packageJson = __importStar(__webpack_require__(8330));
+const update_skills_1 = __webpack_require__(7286);
 const logging_1 = __webpack_require__(443);
 const process_utils_1 = __webpack_require__(8251);
 const resolve_2 = __webpack_require__(3878);
@@ -31247,21 +31330,38 @@ const version_check_1 = __webpack_require__(4827);
 // - Default: colors only if TTY (stdout is a terminal).
 const isTerminal = process.stdout.isTTY;
 const useColorsInOutput = (0, process_env_utils_1.isEnvVarTruthy)('FORCE_COLOR') || (!(0, process_env_utils_1.isEnvVarTruthy)('NO_COLOR') && isTerminal);
-async function displayVersionWarning(versionCheckPromise) {
-    try {
-        const versionWarning = await versionCheckPromise;
-        if (versionWarning) {
-            console.warn(versionWarning);
+/**
+ * Add Python source files and requirements.txt to a zip archive.
+ * Used by both Python-only and hybrid builds.
+ */
+function addPythonFilesToBundle(zip) {
+    const SKIP_DIRS = new Set(['__pycache__', '__python_deps__']);
+    function addPyFiles(dirPath, zipDir) {
+        for (const entry of fsSync.readdirSync(dirPath, { withFileTypes: true })) {
+            if (entry.name.startsWith('.'))
+                continue;
+            const fullPath = path_1.default.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name))
+                    continue;
+                addPyFiles(fullPath, path_1.default.join(zipDir, entry.name));
+            }
+            else if (entry.isFile() && !entry.name.endsWith('.pyc')) {
+                zip.addLocalFile(fullPath, zipDir || undefined);
+            }
         }
     }
-    catch (_ignored) { }
+    addPyFiles('src', '');
+    if (fsSync.existsSync('requirements.txt')) {
+        zip.addLocalFile('requirements.txt');
+    }
 }
 async function build({ verbose, dev, skipVersionCheck }) {
     const buildPhaseStart = Date.now();
     (0, global_utils_1.enableDebugLogs)(verbose || (0, global_utils_1.isDebugEnabled)());
     (0, logpipes_1.installConsoleOverrides)(enable_debug_decorator_utils_1.debugLogFilterPipe);
     console.debug(`Starting Squid project build. CLI package version: ${packageJson.version}`);
-    await (0, validate_1.validateSquidProject)();
+    const projectInfo = await (0, validate_1.validateSquidProject)();
     // Start version checks in the background if not disabled.
     const shouldSkipVersionCheck = skipVersionCheck || (0, process_env_utils_1.isEnvVarTruthy)('SQUID_SKIP_BUILD_TIME_VERSION_CHECK');
     // SQUID_CURRENT_CLI_VERSION_OVERRIDE is used for testing.
@@ -31273,10 +31373,24 @@ async function build({ verbose, dev, skipVersionCheck }) {
         await fs_1.promises.rm(distPath, { recursive: true, force: true });
     }
     await fs_1.promises.mkdir(distPath);
+    // Python-only projects: zip src/ + requirements.txt, no webpack.
+    if (projectInfo.isPython && !projectInfo.isHybrid) {
+        console.log((0, logging_1.primary)('Building Python bundle...'));
+        const bundlePath = path_1.default.join(distPath, 'bundle.zip');
+        const zip = new adm_zip_1.default();
+        addPythonFilesToBundle(zip);
+        zip.writeZip(bundlePath);
+        const stats = fsSync.statSync(bundlePath);
+        console.log(`Python bundle created: ${bundlePath} (${(stats.size / 1024).toFixed(1)} KB)`);
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
+        (0, update_skills_1.displaySkillsWarningIfOutdated)();
+        console.debug((0, log_utils_1.timeSince)(buildPhaseStart, 'Build time '));
+        return;
+    }
     const isSquidConnector = (0, process_env_utils_1.isEnvVarTruthy)('SQUID_CONNECTOR');
     const specsStart = Date.now();
-    const openApiSpecAndControllers = await tsoa_utils_1.TsoaUtils.generateAllSpecs(verbose, !isSquidConnector);
-    console.debug((0, log_utils_1.timeSince)(specsStart, '⏱ TsoaUtils.generateAllSpecs '));
+    const openApiSpecAndControllers = await tsoa_utils_1.TsoaUtils.generateAllSpecs(process.cwd(), !isSquidConnector, verbose);
+    console.debug((0, log_utils_1.timeSince)(specsStart, 'OpenAPI specs generation time '));
     await fs_1.promises.writeFile(path_1.default.join(distPath, '', 'openapi-spec-and-controllers.json'), JSON.stringify(openApiSpecAndControllers));
     const isUserConfigMode = fsSync.existsSync(resolve_2.USER_WEBPACK_CONFIG_PATH);
     const webpackConfigPath = isUserConfigMode ? resolve_2.USER_WEBPACK_CONFIG_PATH : resolve_2.BUILT_IN_WEBPACK_CONFIG_PATH;
@@ -31291,7 +31405,7 @@ async function build({ verbose, dev, skipVersionCheck }) {
         await new Promise((resolve, reject) => {
             (0, webpack_1.default)(webpackConfig, (err, stats) => {
                 if (err) {
-                    console.debug((0, log_utils_1.timeSince)(webpackStart, '⏱ webpack build '));
+                    console.debug((0, log_utils_1.timeSince)(webpackStart, 'Webpack build time '));
                     console.error('Build failed a fatal error.');
                     return reject(err);
                 }
@@ -31308,34 +31422,47 @@ async function build({ verbose, dev, skipVersionCheck }) {
                     }));
                 }
                 if (stats?.hasErrors()) {
-                    console.debug((0, log_utils_1.timeSince)(webpackStart, '⏱ webpack build '));
+                    console.debug((0, log_utils_1.timeSince)(webpackStart, 'Webpack build time '));
                     return reject(new Error('Build failed with errors.'));
                 }
-                console.debug((0, log_utils_1.timeSince)(webpackStart, '⏱ webpack build '));
+                console.debug((0, log_utils_1.timeSince)(webpackStart, 'Webpack build time '));
                 console.log('Build succeeded.');
                 resolve();
             });
         });
+        // For hybrid projects, add Python files to the webpack-produced bundle.
+        if (projectInfo.isHybrid) {
+            console.log('Adding Python files to hybrid bundle...');
+            const zipPath = path_1.default.join(distPath, 'bundle.zip');
+            const zip = new adm_zip_1.default(zipPath);
+            addPythonFilesToBundle(zip);
+            zip.writeZip(zipPath);
+            console.log('Python files added to bundle.');
+        }
         // Generate connector metadata if this is a connector build.
         if (isSquidConnector) {
             console.debug('Generating connector metadata...');
             const metadataStart = Date.now();
             await generateConnectorMetadata(distPath);
-            console.debug((0, log_utils_1.timeSince)(metadataStart, '⏱ generateConnectorMetadata '));
+            console.debug((0, log_utils_1.timeSince)(metadataStart, 'Connector metadata generation time '));
             // Add metadata to bundle.zip.
+            const metadataBundleStart = Date.now();
             const zipPath = path_1.default.join(distPath, 'bundle.zip');
             const zip = new adm_zip_1.default(zipPath);
             zip.addLocalFile(path_1.default.join(distPath, connector_types_1.CONNECTOR_METADATA_JSON_FILE));
             zip.writeZip(zipPath);
             console.debug('Added connector metadata to bundle.zip');
+            console.debug((0, log_utils_1.timeSince)(metadataBundleStart, 'Connector metadata bundling time '));
         }
         // Show version check warning after successful build.
-        await displayVersionWarning(versionCheckPromise);
-        console.debug((0, log_utils_1.timeSince)(buildPhaseStart, '⏱ Total CLI build time '));
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
+        (0, update_skills_1.displaySkillsWarningIfOutdated)();
+        console.debug((0, log_utils_1.timeSince)(buildPhaseStart, 'Build time '));
     }
     catch (e) {
         // Show a version check warning even if the build failed.
-        await displayVersionWarning(versionCheckPromise);
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
+        (0, update_skills_1.displaySkillsWarningIfOutdated)();
         const errorMessage = (0, assertic_1.getMessageFromError)(e);
         console.debug(`Exiting with error: ${errorMessage}`);
         (0, process_utils_1.exitWithError)(errorMessage);
@@ -31443,12 +31570,16 @@ const enable_debug_decorator_utils_1 = __webpack_require__(8700);
 const global_utils_1 = __webpack_require__(6334);
 const http_1 = __webpack_require__(866);
 const shell_runner_1 = __webpack_require__(3089);
+const packageJson = __importStar(__webpack_require__(8330));
 const environment_1 = __webpack_require__(722);
 const process_utils_1 = __webpack_require__(8251);
+const version_check_1 = __webpack_require__(4827);
 async function deploy(consoleRegion, appId, bundlePath, apiKey, verbose, direct, isUserSpecifiedPath, skipBuild, internalApiKey, environmentId) {
     (0, global_utils_1.enableDebugLogs)(verbose || (0, global_utils_1.isDebugEnabled)());
     (0, logpipes_1.installConsoleOverrides)(enable_debug_decorator_utils_1.debugLogFilterPipe);
+    const versionCheckPromise = (0, version_check_1.checkCliVersion)(packageJson.version);
     if (!direct && !isUserSpecifiedPath && !skipBuild) {
+        // `squid build` handles all project types: TS, Python-only, and hybrid.
         console.log('Building code bundle...');
         await (0, shell_runner_1.runInShell)('npm run build');
     }
@@ -31477,8 +31608,10 @@ async function deploy(consoleRegion, appId, bundlePath, apiKey, verbose, direct,
             (0, process_utils_1.exitWithError)('Unable to deploy bundle:', await response.text());
         }
         console.log('Code deployed');
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
     }
     catch (error) {
+        await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
         console.debug('Error deploying bundle:', error);
         const errorMessage = (0, assertic_1.getMessageFromError)(error, '');
         (0, process_utils_1.exitWithError)('Unable to deploy bundle:', errorMessage || error);
@@ -31690,10 +31823,12 @@ const init_webpack_1 = __webpack_require__(1134);
 const sample_1 = __webpack_require__(4328);
 const start_1 = __webpack_require__(496);
 const undeploy_1 = __webpack_require__(7097);
+const update_skills_1 = __webpack_require__(7286);
 const process_utils_1 = __webpack_require__(8251);
 const validate_1 = __webpack_require__(2246);
 function setupDotEnv(baseDir) {
-    dotenv.config({ path: path_1.default.resolve(baseDir || './', '.env') });
+    const envPath = path_1.default.resolve(baseDir || './', '.env');
+    dotenv.config({ path: envPath });
 }
 function run() {
     (0, yargs_1.default)(process.argv.slice(2))
@@ -31714,6 +31849,7 @@ function run() {
     setupInitWebpackCommand(yargs_1.default);
     setupStartCommand(yargs_1.default);
     setupUndeployCommand(yargs_1.default);
+    setupUpdateSkillsCommand(yargs_1.default);
     yargs_1.default.parse();
 }
 function setupStartCommand(yargs) {
@@ -31844,6 +31980,11 @@ function setupBuildCommand(yargs) {
         await (0, build_1.build)({ verbose: !!argv.verbose, dev: !!argv.dev, skipVersionCheck: !!argv['skip-version-check'] });
     });
 }
+function setupUpdateSkillsCommand(yargs) {
+    yargs.command('update-skills', 'Updates Squid Claude skills to the latest version', () => { }, async () => {
+        await (0, update_skills_1.updateSkills)();
+    });
+}
 run();
 function attachAppIdOption(yargs, demandOption) {
     yargs.option('appId', {
@@ -31973,6 +32114,39 @@ function getConsoleRegionFromAppRegion(appRegion) {
 
 "use strict";
 
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -31987,14 +32161,18 @@ const utils_1 = __webpack_require__(1215);
 const enable_debug_decorator_utils_1 = __webpack_require__(8700);
 const global_utils_1 = __webpack_require__(6334);
 const shell_runner_1 = __webpack_require__(3089);
+const packageJson = __importStar(__webpack_require__(8330));
+const update_skills_1 = __webpack_require__(7286);
 const git_utils_1 = __webpack_require__(954);
 const logging_1 = __webpack_require__(443);
 const process_utils_1 = __webpack_require__(8251);
 const report_utils_1 = __webpack_require__(3066);
+const version_check_1 = __webpack_require__(4827);
 const ORG = 'squid-cloud-samples';
 async function initSample(consoleRegion, isOnPremConsole, dirPath, appId, apiKey, environmentId, squidDeveloperId, region, templateName, verbose = false) {
     (0, global_utils_1.enableDebugLogs)(verbose || (0, global_utils_1.isDebugEnabled)());
     (0, logpipes_1.installConsoleOverrides)(enable_debug_decorator_utils_1.debugLogFilterPipe);
+    const versionCheckPromise = (0, version_check_1.checkCliVersion)(packageJson.version);
     try {
         await promises_1.default.stat(path_1.default.resolve(dirPath));
         (0, process_utils_1.exitWithError)(`Project already exists: ${dirPath}`);
@@ -32014,42 +32192,25 @@ async function initSample(consoleRegion, isOnPremConsole, dirPath, appId, apiKey
     catch {
         (0, process_utils_1.exitWithError)(`Unable to download repository: ${templateRepoPath}`);
     }
-    // Copy the squid-development and squid-react-development skills if they do not already exist.
+    // Copy Squid skills if they don't already exist.
     const projectPath = path_1.default.resolve(dirPath);
     const skillsDir = path_1.default.join(projectPath, '.claude', 'skills');
-    const squidSkillSourcePath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', 'squid-development');
-    const squidSkillDestPath = path_1.default.join(skillsDir, 'squid-development');
-    if (await (0, utils_1.checkFileOrDirExists)(squidSkillDestPath)) {
-        console.debug('Squid development skill already exists, skipping...');
-    }
-    else {
-        // Skill doesn't exist, copy it.
-        try {
-            await promises_1.default.mkdir(skillsDir, { recursive: true });
-            await promises_1.default.cp(squidSkillSourcePath, squidSkillDestPath, { recursive: true });
-            console.debug('Squid development skill copied successfully');
-        }
-        catch (error) {
-            // Non-fatal: log the error but continue with initialization.
-            console.debug(`Warning: Could not copy Squid development skill: ${(0, assertic_1.getMessageFromError)(error)}`);
-        }
-    }
-    // Copy the squid-react-development skill if it doesn't already exist.
-    const reactSkillSourcePath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', 'squid-react-development');
-    const reactSkillDestPath = path_1.default.join(skillsDir, 'squid-react-development');
-    if (await (0, utils_1.checkFileOrDirExists)(reactSkillDestPath)) {
-        console.debug('Squid React development skill already exists, skipping...');
-    }
-    else {
-        // Skill doesn't exist, copy it.
-        try {
-            await promises_1.default.mkdir(skillsDir, { recursive: true });
-            await promises_1.default.cp(reactSkillSourcePath, reactSkillDestPath, { recursive: true });
-            console.debug('Squid React development skill copied successfully');
+    for (const skillName of update_skills_1.SQUID_SKILLS) {
+        const sourcePath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', skillName);
+        const destPath = path_1.default.join(skillsDir, skillName);
+        if (await (0, utils_1.checkFileOrDirExists)(destPath)) {
+            console.debug(`${skillName} skill already exists, skipping...`);
         }
-        catch (error) {
-            // Non-fatal: log the error but continue with initialization.
-            console.debug(`Warning: Could not copy Squid React development skill: ${(0, assertic_1.getMessageFromError)(error)}`);
+        else {
+            try {
+                await promises_1.default.mkdir(skillsDir, { recursive: true });
+                await promises_1.default.cp(sourcePath, destPath, { recursive: true });
+                console.debug(`${skillName} skill copied successfully`);
+            }
+            catch (error) {
+                // Non-fatal: log the error but continue with initialization.
+                console.debug(`Warning: Could not copy ${skillName} skill: ${(0, assertic_1.getMessageFromError)(error)}`);
+            }
         }
     }
     console.log('Installing dependencies...');
@@ -32112,6 +32273,7 @@ ${(0, logging_1.primary)('Done. Next steps:')}
   npm run start
 `);
     }
+    await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
 }
 
 
@@ -32160,52 +32322,111 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.start = start;
+const fs_1 = __webpack_require__(9896);
 const fs = __importStar(__webpack_require__(1943));
 const path_1 = __importDefault(__webpack_require__(6928));
 const resolve_1 = __webpack_require__(412);
 const shell_runner_1 = __webpack_require__(3089);
+const cliPackageJson = __importStar(__webpack_require__(8330));
+const update_skills_1 = __webpack_require__(7286);
 const logging_1 = __webpack_require__(443);
 const process_utils_1 = __webpack_require__(8251);
 const validate_1 = __webpack_require__(2246);
+const version_check_1 = __webpack_require__(4827);
 async function start() {
-    const packageJson = await (0, validate_1.validateSquidProject)();
+    const projectInfo = await (0, validate_1.validateSquidProject)();
+    const versionCheckPromise = (0, version_check_1.checkCliVersion)(cliPackageJson.version);
     console.log((0, logging_1.primary)('Please note:'), 'to debug your application, you need to run the "start" npm script in your IDE in debug mode');
+    await (0, version_check_1.displayVersionWarningIfOutdated)(versionCheckPromise);
+    (0, update_skills_1.displaySkillsWarningIfOutdated)();
     console.log((0, logging_1.primary)('Starting...'));
+    if (projectInfo.isPython && !projectInfo.isHybrid) {
+        await startPython();
+        return;
+    }
+    // For hybrid projects, log Python detection
+    if (projectInfo.isHybrid) {
+        console.log((0, logging_1.primary)('Hybrid project detected:'), 'TypeScript + Python');
+    }
+    const packageJson = projectInfo.packageJson;
+    // Check for local development override
+    const localBackendPath = process.env['SQUID_LOCAL_BACKEND_PATH'];
+    if (localBackendPath) {
+        // Local development mode: use nest start from local-backend with SQUID_BACKEND_PATH
+        console.log('Using local-backend from SQUID_LOCAL_BACKEND_PATH:', localBackendPath);
+        const backendPath = process.cwd();
+        await (0, shell_runner_1.runInShell)(`npx nest start --exec "node -r ts-node/register -r tsconfig-paths/register src/main.ts"`, true, localBackendPath, { SQUID_BACKEND_PATH: backendPath });
+        return;
+    }
     const modulePath = await (0, resolve_1.findModulePath)('@squidcloud/local-backend');
     if (!modulePath) {
         (0, process_utils_1.exitWithError)(validate_1.INVALID_PROJECT_ERROR);
     }
     if (packageJson.scripts?.['start-squid']) {
         await (0, shell_runner_1.runInShell)(`npm run start-squid`);
+        return;
     }
-    else {
-        // Detect if CLI is running as TypeScript (dev mode)
-        const isDevMode = __filename.endsWith('.ts');
-        let mainPath;
-        // In dev mode, try to use local-backend source files
-        if (isDevMode) {
-            const localBackendSrc = path_1.default.resolve(__dirname, '../../local-backend/src/main.ts');
-            try {
-                await fs.access(localBackendSrc);
-                mainPath = localBackendSrc;
-                console.log((0, logging_1.primary)('Dev mode detected:'), `using local-backend source files: ${mainPath}`);
-            }
-            catch (_) {
-                // Fall back to built version if source files not found
-                mainPath = path_1.default.resolve(modulePath, '../main.js');
-            }
-        }
-        else {
-            mainPath = path_1.default.resolve(modulePath, '../main.js');
-        }
+    // Detect if CLI is running as TypeScript (dev mode)
+    const isDevMode = __filename.endsWith('.ts');
+    let mainPath;
+    // In dev mode, try to use local-backend source files
+    if (isDevMode) {
+        const localBackendSrc = path_1.default.resolve(__dirname, '../../local-backend/src/main.ts');
         try {
-            await fs.access(mainPath);
-            await (0, shell_runner_1.runInShell)(`npx nodemon --watch ./src --watch ./.env --ext ts,js,json --quiet --exec node -r ts-node/register -r tsconfig-paths/register "${mainPath}"`);
+            await fs.access(localBackendSrc);
+            mainPath = localBackendSrc;
+            console.log((0, logging_1.primary)('Dev mode detected:'), `using local-backend source files: ${mainPath}`);
         }
         catch (_) {
-            (0, process_utils_1.exitWithError)(validate_1.INVALID_PROJECT_ERROR);
+            // Fall back to built version if source files not found
+            mainPath = path_1.default.resolve(modulePath, '../main.js');
         }
     }
+    else {
+        mainPath = path_1.default.resolve(modulePath, '../main.js');
+    }
+    try {
+        await fs.access(mainPath);
+        const ext = projectInfo.isHybrid ? 'py,ts,js,json' : 'ts,js,json';
+        const ignore = projectInfo.isHybrid ? ' --ignore __python_deps__' : '';
+        await (0, shell_runner_1.runInShell)(`npx nodemon --watch ./src --watch ./.env${ignore} --ext ${ext} --quiet --exec node -r ts-node/register -r tsconfig-paths/register "${mainPath}"`);
+    }
+    catch (_) {
+        (0, process_utils_1.exitWithError)(validate_1.INVALID_PROJECT_ERROR);
+    }
+}
+async function startPython() {
+    console.log((0, logging_1.primary)('Python backend detected.'));
+    const backendPath = process.cwd();
+    // Resolve local-backend path (realpathSync handles symlinks from npm link)
+    const modulePath = await (0, resolve_1.findModulePath)('@squidcloud/local-backend');
+    let localBackendDir;
+    const isDevMode = __filename.endsWith('.ts');
+    if (isDevMode) {
+        localBackendDir = path_1.default.resolve(__dirname, '../../local-backend');
+    }
+    else if (modulePath) {
+        // modulePath points to the package entry (e.g. dist/index.js), resolve to package root
+        localBackendDir = (0, fs_1.realpathSync)(path_1.default.resolve(modulePath, '..'));
+    }
+    else {
+        (0, process_utils_1.exitWithError)(validate_1.INVALID_PROJECT_ERROR);
+    }
+    const tsconfigPath = path_1.default.resolve(localBackendDir, 'tsconfig.json');
+    const mainPath = isDevMode ? path_1.default.resolve(localBackendDir, 'src/main.ts') : path_1.default.resolve(localBackendDir, 'main.js');
+    // Python requirements are installed by the local-backend process (with --target for isolation).
+    // No global pip install needed here.
+    const envVars = {
+        SQUID_BACKEND_PATH: backendPath,
+        TS_NODE_PROJECT: tsconfigPath,
+    };
+    try {
+        await fs.access(mainPath);
+        await (0, shell_runner_1.runInShell)(`npx nodemon --watch ./src --watch ./.env --ignore __python_deps__ --ext py,ts,js,json --quiet --exec node -r ts-node/register -r tsconfig-paths/register "${mainPath}"`, true, backendPath, envVars);
+    }
+    catch (_) {
+        (0, process_utils_1.exitWithError)(validate_1.INVALID_PROJECT_ERROR);
+    }
 }
 
 
@@ -32250,6 +32471,149 @@ async function undeploy(consoleRegion, appId, apiKey, environmentId) {
 }
 
 
+/***/ },
+
+/***/ 7286
+(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.SQUID_SKILLS = void 0;
+exports.getSkillsNeedingUpdate = getSkillsNeedingUpdate;
+exports.displaySkillsWarningIfOutdated = displaySkillsWarningIfOutdated;
+exports.updateSkills = updateSkills;
+const chalk_1 = __importDefault(__webpack_require__(7459));
+const fsSync = __importStar(__webpack_require__(9896));
+const fs = __importStar(__webpack_require__(1943));
+const path_1 = __importDefault(__webpack_require__(6928));
+const logging_1 = __webpack_require__(443);
+const validate_1 = __webpack_require__(2246);
+/** List of Squid-owned skills that can be copied/updated. */
+exports.SQUID_SKILLS = ['squid-development', 'squid-react-development'];
+/**
+ * Gets all files in a directory, sorted for consistent ordering.
+ */
+function getFilesSorted(dir) {
+    const files = fsSync.readdirSync(dir, { recursive: true });
+    return files.filter(file => fsSync.statSync(path_1.default.join(dir, file)).isFile()).sort();
+}
+/**
+ * Checks if a specific skill needs to be updated.
+ * Returns true if project is missing skill or any CLI file is missing/different.
+ * Extra files in project are ignored
+ */
+function skillNeedsUpdate(skillName) {
+    const projectSkillPath = path_1.default.join(process.cwd(), '.claude', 'skills', skillName);
+    const cliSkillPath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', skillName);
+    // If CLI doesn't have this skill bundled, nothing to update.
+    if (!fsSync.existsSync(cliSkillPath)) {
+        return false;
+    }
+    // If project doesn't have this skill but CLI does, it needs to be added.
+    if (!fsSync.existsSync(projectSkillPath)) {
+        return true;
+    }
+    // Check each CLI file exists in project with same content.
+    const cliFiles = getFilesSorted(cliSkillPath);
+    for (const file of cliFiles) {
+        const cliFilePath = path_1.default.join(cliSkillPath, file);
+        const projectFilePath = path_1.default.join(projectSkillPath, file);
+        // Project missing a file that CLI has.
+        if (!fsSync.existsSync(projectFilePath)) {
+            return true;
+        }
+        // Content differs (normalize line endings for cross-platform compatibility).
+        const cliContent = fsSync.readFileSync(cliFilePath, 'utf8').replace(/\r\n/g, '\n');
+        const projectContent = fsSync.readFileSync(projectFilePath, 'utf8').replace(/\r\n/g, '\n');
+        if (cliContent !== projectContent) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns a list of skills that need to be updated (missing or outdated).
+ */
+function getSkillsNeedingUpdate() {
+    return exports.SQUID_SKILLS.filter(skillNeedsUpdate);
+}
+function displaySkillsWarningIfOutdated() {
+    try {
+        const skillsToUpdate = getSkillsNeedingUpdate();
+        if (skillsToUpdate.length > 0) {
+            console.warn(chalk_1.default.yellow(`⚠ Squid skills need updating (${skillsToUpdate.join(', ')}). Run: squid update-skills`));
+        }
+    }
+    catch (_ignored) { }
+}
+/**
+ * Updates all Squid-owned skills to the latest version bundled with the CLI.
+ */
+async function updateSkills() {
+    await (0, validate_1.validateSquidProject)();
+    const skillsToUpdate = getSkillsNeedingUpdate();
+    if (skillsToUpdate.length === 0) {
+        console.log(chalk_1.default.green('✓ Skills already up to date'));
+        return;
+    }
+    const skillsDir = path_1.default.join(process.cwd(), '.claude', 'skills');
+    let updatedCount = 0;
+    for (const skillName of skillsToUpdate) {
+        const cliSkillPath = path_1.default.join(__dirname, 'resources', 'claude', 'skills', skillName);
+        const projectSkillPath = path_1.default.join(skillsDir, skillName);
+        try {
+            await fs.mkdir(skillsDir, { recursive: true });
+            await fs.cp(cliSkillPath, projectSkillPath, { recursive: true });
+            console.log(`Updated ${(0, logging_1.primary)(skillName)} skill`);
+            updatedCount++;
+        }
+        catch (_error) {
+            console.warn(`Warning: Could not update ${skillName} skill`);
+        }
+    }
+    if (updatedCount > 0) {
+        console.log(chalk_1.default.green(`✓ ${updatedCount} skill(s) updated successfully`));
+    }
+}
+
+
 /***/ },
 
 /***/ 954
@@ -32398,6 +32762,7 @@ async function reportLocalBackendInitialized(consoleRegion, appId, apiKey) {
     try {
         const headers = new Headers();
         headers.append('Authorization', `ApiKey ${apiKey}`);
+        headers.append('Content-Type', 'application/json');
         const response = await fetch(url, { method: 'POST', body: JSON.stringify({ appId }), headers });
         if (!response.ok) {
             const responseText = await response.text();
@@ -32477,15 +32842,40 @@ exports.validateSquidProject = validateSquidProject;
 const promises_1 = __importDefault(__webpack_require__(1943));
 const process_utils_1 = __webpack_require__(8251);
 exports.INVALID_PROJECT_ERROR = 'Please make sure you are running this command in your Squid project directory';
+async function fileExists(filePath) {
+    try {
+        await promises_1.default.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 async function validateSquidProject() {
+    const hasPython = (await fileExists('src/main.py')) || (await fileExists('src/index.py'));
+    const hasTs = await fileExists('src/index.ts');
+    const isHybrid = hasPython && hasTs;
+    const isPythonOnly = hasPython && !hasTs;
+    if (isPythonOnly) {
+        // Python-only projects may not have package.json with start scripts
+        let packageJson = {};
+        try {
+            const raw = await promises_1.default.readFile('package.json', 'utf8');
+            packageJson = JSON.parse(raw);
+        }
+        catch {
+            // No package.json is fine for Python projects
+        }
+        return { packageJson, isPython: true, isHybrid: false };
+    }
     try {
-        const packageJson = await promises_1.default.readFile('package.json', 'utf8');
-        const parsedJson = JSON.parse(packageJson);
+        const packageJsonRaw = await promises_1.default.readFile('package.json', 'utf8');
+        const parsedJson = JSON.parse(packageJsonRaw);
         const { scripts } = parsedJson;
         if (!scripts?.['start-squid'] && !scripts?.['start']) {
             (0, process_utils_1.exitWithError)(exports.INVALID_PROJECT_ERROR);
         }
-        return parsedJson;
+        return { packageJson: parsedJson, isPython: hasPython, isHybrid };
     }
     catch (_) {
         (0, process_utils_1.exitWithError)(exports.INVALID_PROJECT_ERROR);
@@ -32505,6 +32895,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.checkCliVersion = checkCliVersion;
+exports.displayVersionWarningIfOutdated = displayVersionWarningIfOutdated;
 const assertic_1 = __webpack_require__(3205);
 const chalk_1 = __importDefault(__webpack_require__(7459));
 const time_units_1 = __webpack_require__(1929);
@@ -32581,6 +32972,15 @@ function parseVersion(version) {
 function formatWarningMessage(currentVersion, latestVersion) {
     return chalk_1.default.yellow(`⚠ Your @squidcloud/cli (${currentVersion}) is outdated. Latest: ${latestVersion}. Update: npm install -g @squidcloud/cli@latest`);
 }
+async function displayVersionWarningIfOutdated(versionCheckPromise) {
+    try {
+        const versionWarning = await versionCheckPromise;
+        if (versionWarning) {
+            console.warn(versionWarning);
+        }
+    }
+    catch (_ignored) { }
+}
 
 
 /***/ },
@@ -36921,7 +37321,7 @@ terminalLink.stderr.isSupported = supports_hyperlinks.stderr;
 (module) {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"dotenv","version":"16.6.1","description":"Loads environment variables from .env file","main":"lib/main.js","types":"lib/main.d.ts","exports":{".":{"types":"./lib/main.d.ts","require":"./lib/main.js","default":"./lib/main.js"},"./config":"./config.js","./config.js":"./config.js","./lib/env-options":"./lib/env-options.js","./lib/env-options.js":"./lib/env-options.js","./lib/cli-options":"./lib/cli-options.js","./lib/cli-options.js":"./lib/cli-options.js","./package.json":"./package.json"},"scripts":{"dts-check":"tsc --project tests/types/tsconfig.json","lint":"standard","pretest":"npm run lint && npm run dts-check","test":"tap run --allow-empty-coverage --disable-coverage --timeout=60000","test:coverage":"tap run --show-full-coverage --timeout=60000 --coverage-report=text --coverage-report=lcov","prerelease":"npm test","release":"standard-version"},"repository":{"type":"git","url":"git://github.com/motdotla/dotenv.git"},"homepage":"https://github.com/motdotla/dotenv#readme","funding":"https://dotenvx.com","keywords":["dotenv","env",".env","environment","variables","config","settings"],"readmeFilename":"README.md","license":"BSD-2-Clause","devDependencies":{"@types/node":"^18.11.3","decache":"^4.6.2","sinon":"^14.0.1","standard":"^17.0.0","standard-version":"^9.5.0","tap":"^19.2.0","typescript":"^4.8.4"},"engines":{"node":">=12"},"browser":{"fs":false}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"dotenv","version":"17.3.1","description":"Loads environment variables from .env file","main":"lib/main.js","types":"lib/main.d.ts","exports":{".":{"types":"./lib/main.d.ts","require":"./lib/main.js","default":"./lib/main.js"},"./config":"./config.js","./config.js":"./config.js","./lib/env-options":"./lib/env-options.js","./lib/env-options.js":"./lib/env-options.js","./lib/cli-options":"./lib/cli-options.js","./lib/cli-options.js":"./lib/cli-options.js","./package.json":"./package.json"},"scripts":{"dts-check":"tsc --project tests/types/tsconfig.json","lint":"standard","pretest":"npm run lint && npm run dts-check","test":"tap run tests/**/*.js --allow-empty-coverage --disable-coverage --timeout=60000","test:coverage":"tap run tests/**/*.js --show-full-coverage --timeout=60000 --coverage-report=text --coverage-report=lcov","prerelease":"npm test","release":"standard-version"},"repository":{"type":"git","url":"git://github.com/motdotla/dotenv.git"},"homepage":"https://github.com/motdotla/dotenv#readme","funding":"https://dotenvx.com","keywords":["dotenv","env",".env","environment","variables","config","settings"],"readmeFilename":"README.md","license":"BSD-2-Clause","devDependencies":{"@types/node":"^18.11.3","decache":"^4.6.2","sinon":"^14.0.1","standard":"^17.0.0","standard-version":"^9.5.0","tap":"^19.2.0","typescript":"^4.8.4"},"engines":{"node":">=12"},"browser":{"fs":false}}');
 
 /***/ },
 
@@ -36937,7 +37337,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"name":"seek-bzip","version":"1.0.6",
 (module) {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@squidcloud/cli","version":"1.0.449","description":"The Squid CLI","main":"dist/index.js","scripts":{"start":"node dist/index.js","start-ts":"ts-node -r tsconfig-paths/register src/index.ts","prebuild":"rimraf dist","build":"webpack --mode=production","build:dev":"webpack --mode=development","lint":"eslint","link":"npm run build && chmod 755 dist/index.js && npm link","watch":"webpack --watch","deploy":"npm run build && npm pack --silent | xargs -I {} mv {} package.tgz && npm install -g package.tgz && rm -rf package.tgz","publish:public":"npm run build && npm publish --access public"},"files":["dist/**/*"],"bin":{"squid":"dist/index.js"},"keywords":[],"author":"","license":"ISC","engines":{"node":">=18.0.0"},"dependencies":{"@squidcloud/local-backend":"^1.0.449","adm-zip":"^0.5.16","copy-webpack-plugin":"^12.0.2","decompress":"^4.2.1","logpipes":"^1.11.0","nodemon":"^3.1.9","terser-webpack-plugin":"^5.3.10","ts-loader":"^9.5.1","ts-node":"^10.9.2","tsconfig-paths":"^4.2.0","tsconfig-paths-webpack-plugin":"^4.1.0","webpack":"^5.101.3","zip-webpack-plugin":"^4.0.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/decompress":"^4.2.7","@types/node":"^20.19.9","terminal-link":"^3.0.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@squidcloud/cli","version":"1.0.451","description":"The Squid CLI","main":"dist/index.js","scripts":{"start":"node dist/index.js","start-ts":"ts-node -r tsconfig-paths/register src/index.ts","prebuild":"rimraf dist","build":"webpack --mode=production","build:dev":"webpack --mode=development","lint":"eslint","link":"npm run build && chmod 755 dist/index.js && npm link","watch":"webpack --watch","deploy":"npm run build && npm pack --silent | xargs -I {} mv {} package.tgz && npm install -g package.tgz && rm -rf package.tgz","publish:public":"npm run build && npm publish --access public"},"files":["dist/**/*"],"bin":{"squid":"dist/index.js"},"keywords":[],"author":"","license":"ISC","engines":{"node":">=18.0.0"},"dependencies":{"@squidcloud/local-backend":"^1.0.451","adm-zip":"^0.5.16","copy-webpack-plugin":"^12.0.2","decompress":"^4.2.1","logpipes":"^1.11.0","nodemon":"^3.1.9","terser-webpack-plugin":"^5.3.10","ts-loader":"^9.5.1","ts-node":"^10.9.2","tsconfig-paths":"^4.2.0","tsconfig-paths-webpack-plugin":"^4.1.0","webpack":"^5.101.3","zip-webpack-plugin":"^4.0.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/decompress":"^4.2.7","@types/node":"^20.19.9","terminal-link":"^3.0.0"}}');
 
 /***/ }