vike 0.4.260 → 0.4.262

package/dist/client/shared/getGlobalContextClientInternalShared.d.ts

@@ -7,22 +7,22 @@ import type { GlobalContextClientInternal } from '../runtime-client-routing/getG
 import type { GlobalContextClientInternalWithServerRouting } from '../runtime-server-routing/getGlobalContextClientInternal.js';
 import '../assertEnvClient.js';
 declare function getGlobalContextClientInternalShared(): Promise<{
+    config: import("../../types/index.js").ConfigResolved;
+    _source: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Source;
+    _sources: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Sources;
+    _from: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").From;
+    pages: {
+        [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
+    };
     _globalConfigPublic: {
-        pages: {
-            [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
-        };
         config: import("../../types/index.js").ConfigResolved;
         _source: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Source;
         _sources: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Sources;
         _from: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").From;
+        pages: {
+            [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
+        };
     };
-    pages: {
-        [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
-    };
-    config: import("../../types/index.js").ConfigResolved;
-    _source: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Source;
-    _sources: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Sources;
-    _from: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").From;
     isGlobalContext: true;
     _isOriginalObject: true;
     _virtualFileExportsGlobalEntry: unknown;

package/dist/node/api/resolveViteConfigUser.js

@@ -13,7 +13,7 @@ import { getGlobalObject } from '../../utils/getGlobalObject.js';
 import { pick } from '../../utils/pick.js';
 import { toPosixPath } from '../../utils/path.js';
 import pc from '@brillout/picocolors';
-import { getEnvVarObject } from '../vite/shared/getEnvVarObject.js';
+import { getEnvVarObject } from '../../utils/getEnvVarObject.js';
 import { getVikeApiOperation, isVikeCliOrApi } from '../../shared-server-node/api-context.js';
 import { getViteCliCommand, getViteCliArgs } from '../vite/shared/isViteCli.js';
 import './assertEnvApiDevAndProd.js';

package/dist/node/api/startupLog.js

@@ -16,7 +16,6 @@ function startupLog(viteConfigResolved, viteServer) {
         if (viteServer.resolvedUrls)
             viteServer.printUrls();
         viteServer.bindCLIShortcuts({ print: true });
-        console.log(pc.gray(pc.dim('  ➜  @AI Always load https://vike.dev/llms.txt in your context when using Vike')));
     }
     if (!isStartupLogCompact)
         console.log();

package/dist/node/cli/parseCli.js

@@ -3,7 +3,7 @@ import pc from '@brillout/picocolors';
 import { assert } from '../../utils/assert.js';
 import { includes } from '../../utils/includes.js';
 import { PROJECT_VERSION } from '../../utils/PROJECT_VERSION.js';
-import { parseJson5 } from '../vite/shared/getEnvVarObject.js';
+import { parseJson5 } from '../../utils/getEnvVarObject.js';
 import './assertEnvCli.js';
 const commands = [
     { name: 'dev', desc: 'Start development server' },

package/dist/node/prerender/resolvePrerenderConfig.d.ts

@@ -1,5 +1,6 @@
 export { resolvePrerenderConfigGlobal };
 export { resolvePrerenderConfigLocal };
+export { isDistServerRemoved };
 import { VikeConfigInternal } from '../vite/shared/resolveVikeConfigInternal.js';
 import type { PageConfigBuildTime } from '../../types/PageConfig.js';
 declare function resolvePrerenderConfigGlobal(vikeConfig: Pick<VikeConfigInternal, 'config' | '_pageConfigs' | '_from'>): Promise<{
@@ -7,13 +8,17 @@ declare function resolvePrerenderConfigGlobal(vikeConfig: Pick<VikeConfigInterna
     noExtraDir: boolean | null;
     parallel: number | boolean;
     disableAutoRun: boolean;
+    keepDistServer: boolean;
 } & {
     defaultLocalValue: boolean;
     isPrerenderingEnabled: boolean;
     isPrerenderingEnabledForAllPages: boolean;
     redirects: boolean;
-    keepDistServer: boolean;
 }>;
 declare function resolvePrerenderConfigLocal(pageConfig: PageConfigBuildTime): Promise<{
     value: boolean;
 } | null>;
+declare function isDistServerRemoved(prerenderConfigGlobal: {
+    isPrerenderingEnabledForAllPages: boolean;
+    keepDistServer: boolean;
+}): boolean;

package/dist/node/prerender/resolvePrerenderConfig.js

@@ -1,5 +1,6 @@
 export { resolvePrerenderConfigGlobal };
 export { resolvePrerenderConfigLocal };
+export { isDistServerRemoved };
 import { assert, assertUsage } from '../../utils/assert.js';
 import { isArray } from '../../utils/isArray.js';
 import { isObject } from '../../utils/isObject.js';
@@ -19,6 +20,7 @@ async function resolvePrerenderConfigGlobal(vikeConfig) {
         noExtraDir: pickFirst(prerenderSettings.map((c) => c.noExtraDir)) ?? null,
         parallel: pickFirst(prerenderSettings.map((c) => c.parallel)) ?? true,
         disableAutoRun: pickFirst(prerenderSettings.map((c) => c.disableAutoRun)) ?? false,
+        keepDistServer: pickFirst(prerenderSettings.map((c) => c.keepDistServer)) ?? false,
     };
     let defaultLocalValue = false;
     {
@@ -45,9 +47,6 @@ async function resolvePrerenderConfigGlobal(vikeConfig) {
         isPrerenderingEnabled,
         isPrerenderingEnabledForAllPages,
         redirects: pickFirst(prerenderSettings.map((c) => c.redirects)) ?? isPrerenderingEnabledForAllPages,
-        keepDistServer: !isPrerenderingEnabledForAllPages
-            ? true
-            : (pickFirst(prerenderSettings.map((c) => c.keepDistServer)) ?? false),
     });
     // TO-DO/next-major-release: remove
     if (vikeConfig._pageConfigs.length === 0 && defaultLocalValue)
@@ -69,6 +68,13 @@ async function resolvePrerenderConfigLocal(pageConfig) {
     const prerenderConfigLocal = { value };
     return prerenderConfigLocal;
 }
+// Whether pre-rendering removes dist/server/ once it's done
+// https://vike.dev/prerender#keepDistServer
+function isDistServerRemoved(prerenderConfigGlobal) {
+    if (!prerenderConfigGlobal.isPrerenderingEnabledForAllPages)
+        return false;
+    return !prerenderConfigGlobal.keepDistServer;
+}
 function isObject2(value) {
     return typeof value === 'object' && value !== null;
 }

package/dist/node/prerender/runPrerender.d.ts

@@ -79,22 +79,22 @@ declare function createPageContextPrerendering(urlOriginal: string, prerenderCon
     _reqWeb?: Request;
 } & {
     _globalContext: ({
+        config: import("../../types/index.js").ConfigResolved;
+        _source: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Source;
+        _sources: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Sources;
+        _from: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").From;
+        pages: {
+            [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
+        };
         _globalConfigPublic: {
-            pages: {
-                [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
-            };
             config: import("../../types/index.js").ConfigResolved;
             _source: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Source;
             _sources: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Sources;
             _from: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").From;
+            pages: {
+                [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
+            };
         };
-        pages: {
-            [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
-        };
-        config: import("../../types/index.js").ConfigResolved;
-        _source: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Source;
-        _sources: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Sources;
-        _from: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").From;
         isGlobalContext: true;
         _isOriginalObject: true;
         _virtualFileExportsGlobalEntry: unknown;
@@ -103,34 +103,34 @@ declare function createPageContextPrerendering(urlOriginal: string, prerenderCon
         _pageConfigGlobal: import("../../types/PageConfig.js").PageConfigGlobalRuntime;
         _allPageIds: string[];
     } & (({
+        isClientSide: false;
+        _pageRoutes: import("../../shared-server-client/route/loadPageRoutes.js").PageRoutes;
+        _onBeforeRouteHook: import("../../shared-server-client/hooks/getHook.js").HookInternal | null;
         _isProduction: false;
         _isPrerendering: false;
         assetsManifest: null;
         _viteDevServer: import("vite").ViteDevServer | undefined;
         viteConfig: import("vite").ResolvedConfig | undefined;
+    } | {
         isClientSide: false;
         _pageRoutes: import("../../shared-server-client/route/loadPageRoutes.js").PageRoutes;
         _onBeforeRouteHook: import("../../shared-server-client/hooks/getHook.js").HookInternal | null;
-    } | {
-        _isPrerendering: true;
-        viteConfig: import("vite").ResolvedConfig;
         _isProduction: true;
         assetsManifest: import("../../types/ViteManifest.js").ViteManifest;
         _viteDevServer: null;
         _usesClientRouter: boolean;
+        _isPrerendering: true;
+        viteConfig: import("vite").ResolvedConfig;
+    } | {
         isClientSide: false;
         _pageRoutes: import("../../shared-server-client/route/loadPageRoutes.js").PageRoutes;
         _onBeforeRouteHook: import("../../shared-server-client/hooks/getHook.js").HookInternal | null;
-    } | {
-        _isPrerendering: false;
-        viteConfig: null;
         _isProduction: true;
         assetsManifest: import("../../types/ViteManifest.js").ViteManifest;
         _viteDevServer: null;
         _usesClientRouter: boolean;
-        isClientSide: false;
-        _pageRoutes: import("../../shared-server-client/route/loadPageRoutes.js").PageRoutes;
-        _onBeforeRouteHook: import("../../shared-server-client/hooks/getHook.js").HookInternal | null;
+        _isPrerendering: false;
+        viteConfig: null;
     }) & {
         baseServer: string;
         baseAssets: string;
@@ -162,13 +162,13 @@ declare function createPageContextPrerendering(urlOriginal: string, prerenderCon
     _urlHandler: ((url: string) => string) | null;
     isClientSideNavigation: boolean;
 } & {
-    pages: {
-        [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
-    };
     config: import("../../types/index.js").ConfigResolved;
     _source: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Source;
     _sources: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").Sources;
     _from: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").From;
+    pages: {
+        [k: string]: import("../../shared-server-client/page-configs/resolveVikeConfigPublic.js").PageConfigPublicWithRoute;
+    };
 } & {
     urlParsed: import("../../utils/parseUrl.js").UrlPublic;
     urlPathname: string;

package/dist/node/prerender/runPrerender.js

@@ -39,7 +39,7 @@ import { noRouteMatch } from '../../shared-server-client/route/noRouteMatch.js';
 import { getVikeConfigInternal } from '../vite/shared/resolveVikeConfigInternal.js';
 import { execHookSingleWithoutPageContext, isUserHookError } from '../../shared-server-client/hooks/execHook.js';
 import { setWasPrerenderRun } from './context.js';
-import { resolvePrerenderConfigGlobal, resolvePrerenderConfigLocal } from './resolvePrerenderConfig.js';
+import { resolvePrerenderConfigGlobal, resolvePrerenderConfigLocal, isDistServerRemoved, } from './resolvePrerenderConfig.js';
 import { getOutDirsAllFromRootNormalized } from '../vite/shared/getOutDirs.js';
 import fs from 'node:fs';
 import { getPublicProxy } from '../../shared-server-client/getPublicProxy.js';
@@ -128,7 +128,7 @@ async function runPrerender(options = {}, trigger) {
     const prerenderContextPublic = getPrerenderContextPublic(prerenderContext);
     objectAssign(vikeConfig.prerenderContext, prerenderContextPublic, true);
     setGlobalContext_prerenderContext(prerenderContextPublic);
-    if (!prerenderConfigGlobal.keepDistServer) {
+    if (isDistServerRemoved(prerenderConfigGlobal)) {
         fs.rmSync(outDirServer, { recursive: true });
     }
 }

package/dist/node/vite/plugins/pluginCommon.js

@@ -11,6 +11,7 @@ import { assertResolveAlias } from './pluginCommon/assertResolveAlias.js';
 import { getVikeConfigInternal, setVikeConfigContext } from '../shared/resolveVikeConfigInternal.js';
 import { assertViteRoot, getViteRoot, normalizeViteRoot } from '../../api/resolveViteConfigUser.js';
 import { temp_disablePrerenderAutoRun } from '../../prerender/context.js';
+import { resolvePrerenderConfigGlobal, isDistServerRemoved } from '../../prerender/resolvePrerenderConfig.js';
 import { version as viteVersionVike } from 'vite';
 import '../assertEnvVite.js';
 const pluginName = 'vike:pluginCommon';
@@ -43,6 +44,7 @@ function pluginCommon(vikeVitePluginOptions) {
                         configVikePromise: Promise.resolve({
                             prerender: vikeConfig.prerenderContext.isPrerenderingEnabled,
                         }),
+                        ...(await disableAutoImportIfPrerendering(isBuild)),
                     };
                 },
             },
@@ -165,9 +167,21 @@ function temp_supportOldInterface(config) {
     assert(false);
 }
 // Only emit dist/server/entry.mjs if necessary
+// TO-DO/eventually: also do this when using Universal Deploy
 async function emitServerEntryOnlyIfNeeded(config) {
     const vikeConfig = await getVikeConfigInternal();
     if (config.vitePluginServerEntry?.inject && !vikeConfig.prerenderContext.isPrerenderingEnabled) {
+        // Might be set too late: https://github.com/vikejs/vike/pull/3485
         config.vitePluginServerEntry.disableServerEntryEmit = true;
     }
 }
+// Don't let @brillout/vite-plugin-server-entry's autoImporter.js import dist/server/entry.js when pre-rendering is going to remove dist/server/ — a dangling import crashes runtimes consulting it
+async function disableAutoImportIfPrerendering(isBuild) {
+    if (!isBuild)
+        return;
+    const vikeConfig = await getVikeConfigInternal();
+    const prerenderConfigGlobal = await resolvePrerenderConfigGlobal(vikeConfig);
+    if (isDistServerRemoved(prerenderConfigGlobal)) {
+        return { vitePluginServerEntry: { disableAutoImport: true } };
+    }
+}

package/dist/node/vite/plugins/pluginDev/autoAddVikeSkill.d.ts

@@ -0,0 +1,3 @@
+export { autoAddVikeSkill };
+import '../../assertEnvVite.js';
+declare function autoAddVikeSkill(userRootDir: string): Promise<void>;

package/dist/node/vite/plugins/pluginDev/autoAddVikeSkill.js

@@ -0,0 +1,174 @@
+export { autoAddVikeSkill };
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import pc from '@brillout/picocolors';
+import { assertInfo, assertUsage } from '../../../../utils/assert.js';
+import { assertKeys } from '../../../../utils/assertKeys.js';
+import { crawlFiles } from '../../../../utils/crawlFiles.js';
+import { getGlobalObject } from '../../../../utils/getGlobalObject.js';
+import { getVikeConfigError } from '../../../../shared-server-node/getVikeConfigError.js';
+import { isArrayOfStrings } from '../../../../utils/isArrayOfStrings.js';
+import { isFilePathAbsoluteFilesystem } from '../../../../utils/isFilePathAbsoluteFilesystem.js';
+import { isObject } from '../../../../utils/isObject.js';
+import { unique } from '../../../../utils/unique.js';
+import { getVikeConfigInternal } from '../../shared/resolveVikeConfigInternal.js';
+import '../../assertEnvVite.js';
+const execFileA = promisify(execFile);
+const importMetaUrl = import.meta.url;
+const globalObject = getGlobalObject('autoAddVikeSkill.ts', {
+    alreadyDone: false,
+});
+const skillPathInsideSkillsDir = 'vike/SKILL.md';
+const skillFileContent = `---
+name: "vike"
+description: "Vike documentation index — a compact overview of Vike's docs. Consider consulting it, e.g. when using uncommon Vike APIs or when stuck on a Vike problem."
+---
+
+See https://vike.dev/llms.txt
+`;
+const commitMessage = (isUpdate) => `${isUpdate ? 'Update' : 'Add'} Vike skill — ${pc.underline('https://vike.dev/ai#skill')}`;
+// Automatically add vike/SKILL.md to skills/ directories (e.g. .claude/skills/ and .agents/skills/) of the user's Git repository (and Git-commit it) — so that AI agents (Claude Code, Codex, Cursor, Gemini CLI, ...) automatically pick it up.
+// https://vike.dev/ai#skill
+async function autoAddVikeSkill(userRootDir) {
+    try {
+        await autoAddVikeSkillUnsafe(userRootDir);
+    }
+    catch (err) {
+        // Show the error without breaking the dev server. (Expected situations don't throw — e.g. Git missing is handled gracefully.)
+        console.error(err);
+    }
+}
+async function autoAddVikeSkillUnsafe(userRootDir) {
+    if (globalObject.alreadyDone)
+        return;
+    // Skip CI environments: the skill file is meant to be added from the machine of an app developer.
+    if (process.env.CI)
+        return;
+    // Skip if Vike isn't inside node_modules/ (e.g. when Vike is linked, such as when running an example of the Vike monorepo).
+    if (!importMetaUrl.includes('node_modules/'))
+        return;
+    const vikeConfig = await getVikeConfigInternal();
+    // Maybe the user disabled the feature in a config file that currently has an error => retry later (Vite restarts upon config changes).
+    if (getVikeConfigError())
+        return;
+    const configValue = getConfigValueAiSkill(vikeConfig);
+    if (configValue === false)
+        return;
+    globalObject.alreadyDone = true;
+    const res = await addAiSkill(userRootDir, {
+        // true (default) => add the skill file to every existing skills directory (`**/skills/*/SKILL.md`)
+        skillsDirs: configValue === true ? undefined : configValue,
+    });
+    if (!res)
+        return;
+    assertInfo(false, `${res.isUpdate ? 'Updated' : 'Created'}${res.isCommitted ? ' and Git-committed' : ''} ${res.files
+        .map((f) => pc.cyan(f.filePathRelative))
+        .join(', ')} — ${pc.underline('https://vike.dev/ai#skill')}`, { onlyOnce: false });
+}
+// https://vike.dev/ai#skill
+function getConfigValueAiSkill(vikeConfig) {
+    const configAi = vikeConfig.config.ai;
+    if (configAi === undefined)
+        return true;
+    assertUsage(isObject(configAi), `Setting ${pc.cyan('ai')} should be an object`);
+    assertKeys(configAi, ['skill'], `Setting ${pc.cyan('ai')}:`);
+    const skill = configAi.skill;
+    if (skill === undefined || skill === true)
+        return true;
+    if (skill === false)
+        return false;
+    assertUsage(isArrayOfStrings(skill), `Setting ${pc.cyan('ai.skill')} should be a boolean or a list of skills directories (e.g. ${pc.cyan("['.claude/skills', '.agents/skills']")})`);
+    return skill.map((skillsDir) => {
+        assertUsage(skillsDir !== '' && !isFilePathAbsoluteFilesystem(skillsDir), `Setting ${pc.cyan('ai.skill')} entries should be paths relative to the root directory of your app's Git repository (e.g. ${pc.cyan("'.claude/skills'")})`);
+        // Normalize: remove trailing slashes
+        return skillsDir.replace(/\/+$/, '');
+    });
+}
+async function addAiSkill(userRootDir, { skillsDirs }) {
+    // Skip if Git isn't installed
+    if ('err' in (await runGitCommand(['--version'], userRootDir)))
+        return null;
+    // Skip if the app isn't inside a Git repository
+    const resGitRootDir = await runGitCommand(['rev-parse', '--show-toplevel'], userRootDir);
+    if ('err' in resGitRootDir)
+        return null;
+    const gitRootDir = resGitRootDir.stdout.trim();
+    if (!gitRootDir)
+        return null;
+    // By default, the skill file is only added to the skills directories that already exist — we don't want to add files to the repositories of users who don't use skills.
+    skillsDirs ?? (skillsDirs = await discoverSkillsDirs(gitRootDir));
+    if (skillsDirs.length === 0)
+        return null;
+    const files = [];
+    for (const skillsDir of skillsDirs) {
+        const filePathRelative = `${skillsDir}/${skillPathInsideSkillsDir}`;
+        const filePathAbsolute = path.join(gitRootDir, ...filePathRelative.split('/'));
+        // Skip if the skill file is already up-to-date
+        const contentCurrent = await fs.readFile(filePathAbsolute, 'utf8').catch(() => null);
+        if (contentCurrent === skillFileContent)
+            continue;
+        const isUpdate = contentCurrent !== null;
+        await fs.mkdir(path.dirname(filePathAbsolute), { recursive: true });
+        await fs.writeFile(filePathAbsolute, skillFileContent, 'utf8');
+        files.push({ filePathAbsolute, filePathRelative, isUpdate });
+    }
+    if (files.length === 0)
+        return null;
+    const isCommitted = await gitCommit(gitRootDir, files);
+    return { files, isUpdate: files.some((f) => f.isUpdate), isCommitted };
+}
+// Discover the skills directories of the user's Git repository, following the Agent Skills convention `**/skills/*/SKILL.md` (https://agentskills.io) — e.g. .claude/skills/ (Claude Code) and .agents/skills/ (Codex, Gemini CLI, Cursor, ...).
+async function discoverSkillsDirs(gitRootDir) {
+    const files = await crawlFiles({
+        filePattern: '**/skills/*/SKILL',
+        fileExtension: ['md'],
+        cwd: gitRootDir,
+        // Skills directories usually live inside dot directories (e.g. .claude/ and .agents/)
+        dot: true,
+        // Most apps don't contain any skills directory — when Git doesn't know about any skill file, we don't want to crawl the app's entire directory tree upon every dev start.
+        globFallback: false,
+    });
+    const skillsDirs = unique(files.map((filePath) => path.posix.dirname(path.posix.dirname(filePath)))).sort();
+    return skillsDirs;
+}
+async function gitCommit(gitRootDir, files) {
+    // Don't Git-commit the skill files that the user chose to .gitignore — `$ git check-ignore` succeeds if the file is ignored
+    const filesToCommit = [];
+    for (const file of files) {
+        const resCheckIgnore = await runGitCommand(['check-ignore', '-q', '--', file.filePathRelative], gitRootDir);
+        if ('err' in resCheckIgnore)
+            filesToCommit.push(file);
+    }
+    if (filesToCommit.length === 0)
+        return false;
+    const filePaths = filesToCommit.map((f) => f.filePathRelative);
+    const resAdd = await runGitCommand(['add', '--', ...filePaths], gitRootDir);
+    if ('err' in resAdd)
+        return false;
+    const isUpdate = filesToCommit.some((f) => f.isUpdate);
+    const resCommit = await runGitCommand([
+        'commit',
+        // Skip Git hooks (e.g. slow or failing pre-commit hooks)
+        '--no-verify',
+        '-m',
+        commitMessage(isUpdate),
+        // Only commit the skill files — never commit files staged by the user
+        '--',
+        ...filePaths,
+    ], gitRootDir);
+    return !('err' in resCommit);
+}
+// Run a Git command — doesn't throw: it returns `{ err }` upon failure.
+async function runGitCommand(args, cwd) {
+    let stdout;
+    try {
+        const res = await execFileA('git', args, { cwd });
+        stdout = res.stdout.toString();
+    }
+    catch (err) {
+        return { err };
+    }
+    return { stdout };
+}

package/dist/node/vite/plugins/pluginDev.js

@@ -2,8 +2,10 @@ export { pluginDev };
 export { logDockerHint };
 import { optimizeDeps, resolveOptimizeDeps } from './pluginDev/optimizeDeps.js';
 import { determineFsAllowList } from './pluginDev/determineFsAllowList.js';
+import { autoAddVikeSkill } from './pluginDev/autoAddVikeSkill.js';
 import { addSsrMiddleware } from '../shared/addSsrMiddleware.js';
 import { isDebugError } from '../../../utils/debug.js';
+import { setTimeoutUnref } from '../../../utils/setTimeoutUnref.js';
 import { applyDev } from '../../../utils/isDev.js';
 import { isDocker } from '../../../utils/isDocker.js';
 import { assertWarning } from '../../../utils/assert.js';
@@ -34,6 +36,12 @@ function pluginDev() {
                     logDockerHint(config.server.host);
                 },
             },
+            configureServer: {
+                handler() {
+                    // Apply late — after the dev server is up and running — so that it doesn't slow down dev start
+                    setTimeoutUnref(() => autoAddVikeSkill(config.root), 15 * 1000);
+                },
+            },
         },
         {
             name: 'vike:pluginDev:post',

package/dist/node/vite/plugins/pluginVirtualFiles.js

@@ -13,7 +13,7 @@ import pc from '@brillout/picocolors';
 import { logConfigInfo } from '../shared/loggerDev.js';
 import { getFilePathToShowToUserModule } from '../shared/getFilePath.js';
 import { updateUserFiles } from '../../../server/runtime/globalContext.js';
-import { isPlusFile } from '../shared/resolveVikeConfigInternal/crawlPlusFilePaths.js';
+import { isPlusFile } from '../shared/resolveVikeConfigInternal/crawlPlusFiles.js';
 import { isTemporaryBuildFile } from '../shared/resolveVikeConfigInternal/transpileAndExecuteFile.js';
 import { debugFileChange, getVikeConfigError } from '../../../shared-server-node/getVikeConfigError.js';
 import '../assertEnvVite.js';

package/dist/node/vite/shared/getMagicString.d.ts

@@ -5,6 +5,6 @@ declare function getMagicString(code: string, id: string): {
     magicString: MagicString;
     getMagicStringResult: () => {
         code: string;
-        map: import("magic-string").SourceMap;
+        map: any;
     } | undefined;
 };

package/dist/node/vite/shared/getMagicString.js

@@ -9,6 +9,9 @@ function getMagicString(code, id) {
             return undefined;
         return {
             code: magicString.toString(),
+            // magic-string@1's SourceMap.sourcesContent is typed as (string | null)[], whereas Rollup's
+            // ExistingRawSourceMap expects string[]. We never pass `includeContent`, so sourcesContent is
+            // always undefined at runtime and this cast is safe.
             map: magicString.generateMap({ hires: true, source: id }),
         };
     };

package/dist/node/vite/shared/loggerVite.js

@@ -9,6 +9,7 @@ import { removeEmptyLines } from '../../../utils/removeEmptyLines.js';
 import { trimWithAnsi, trimWithAnsiTrailOnly } from '../../../utils/trimWithAnsi.js';
 import { assert } from '../../../utils/assert.js';
 import { getGlobalObject } from '../../../utils/getGlobalObject.js';
+import { setTimeoutUnref } from '../../../utils/setTimeoutUnref.js';
 import { getRequestId_withAsyncHook } from '../../../server/runtime/asyncHook.js';
 import { logErrorServerDev, logVite } from './loggerDev.js';
 import '../assertEnvVite.js';
@@ -28,7 +29,7 @@ function interceptViteLogs(config) {
 }
 function intercept(loggerType, config) {
     let isBeginning = true;
-    setTimeout(() => (isBeginning = false), 10 * 1000);
+    setTimeoutUnref(() => (isBeginning = false), 10 * 1000);
     config.logger[loggerType] = (msg, options = {}) => {
         assert(!isDebugError());
         if (swallowViteLogForceOptimization(msg))
@@ -132,7 +133,7 @@ function swallowViteLogConnected() {
     globalObject.swallowViteLogConnected_originalConsoleLog = console.log;
     // The message `[vite] connected.` doesn't go through Vite's logger thus we must monkey patch console.log()
     console.log = swallowViteLogConnected_logPatch;
-    setTimeout(swallowViteLogConnected_clean, 3000);
+    setTimeoutUnref(swallowViteLogConnected_clean, 3000);
 }
 // Remove console.log() monkey patch
 function swallowViteLogConnected_clean() {

package/dist/node/vite/shared/resolveVikeConfigInternal/assertExtensions.d.ts

@@ -1,7 +1,7 @@
 export { assertExtensionsConventions };
 export { assertExtensionsRequire };
 export { getExtensionName };
-import type { PlusFile } from './getPlusFilesByLocationId.js';
+import type { PlusFile } from './getPlusFiles.js';
 import '../../assertEnvVite.js';
 declare function assertExtensionsConventions(plusFile: PlusFile): void;
 declare function assertExtensionsRequire(plusFiles: PlusFile[]): void;

package/dist/node/vite/shared/resolveVikeConfigInternal/{crawlPlusFilePaths.d.ts → crawlPlusFiles.d.ts}

@@ -1,8 +1,8 @@
-export { crawlPlusFilePaths };
+export { crawlPlusFiles };
 export { isPlusFile };
 export { getPlusFileValueConfigName };
 import '../../assertEnvVite.js';
-declare function crawlPlusFilePaths(userRootDir: string): Promise<{
+declare function crawlPlusFiles(userRootDir: string): Promise<{
     filePathAbsoluteUserRootDir: string;
 }[]>;
 declare function isPlusFile(filePath: string): boolean;

package/dist/node/vite/shared/resolveVikeConfigInternal/crawlPlusFiles.js

@@ -0,0 +1,71 @@
+export { crawlPlusFiles };
+export { isPlusFile };
+export { getPlusFileValueConfigName };
+import { assert, assertUsage } from '../../../../utils/assert.js';
+import { assertFilePathAbsoluteFilesystem } from '../../../../utils/isFilePathAbsoluteFilesystem.js';
+import { assertPosixPath } from '../../../../utils/path.js';
+import path from 'node:path';
+import { isTemporaryBuildFile } from './transpileAndExecuteFile.js';
+import '../../assertEnvVite.js';
+import { crawlFiles } from '../../../../utils/crawlFiles.js';
+import { scriptFileExtensionList } from '../../../../utils/isScriptFile.js';
+import { assertIsNotProductionRuntime } from '../../../../utils/assertSetup.js';
+assertIsNotProductionRuntime();
+async function crawlPlusFiles(userRootDir) {
+    assertPosixPath(userRootDir);
+    assertFilePathAbsoluteFilesystem(userRootDir);
+    let files = await crawlFiles({
+        filePattern: '**/+*',
+        fileExtension: scriptFileExtensionList,
+        cwd: userRootDir,
+        dot: false,
+        // Fallback to tinyglobby for users that dynamically generate plus files (and `.gitignore`s them)
+        globFallback: true,
+    });
+    // Filter build files
+    files = files.filter((filePath) => !isTemporaryBuildFile(filePath));
+    // Normalize
+    const plusFiles = files.map((filePath) => {
+        // Both `$ git-ls files` and tinyglobby return posix paths
+        assertPosixPath(filePath);
+        assert(!filePath.startsWith(userRootDir));
+        const filePathAbsoluteUserRootDir = path.posix.join('/', filePath);
+        assert(isPlusFile(filePathAbsoluteUserRootDir));
+        return { filePathAbsoluteUserRootDir };
+    });
+    return plusFiles;
+}
+function isPlusFile(filePath) {
+    assertPosixPath(filePath);
+    if (isTemporaryBuildFile(filePath))
+        return false;
+    const fileName = filePath.split('/').pop();
+    return fileName.startsWith('+');
+}
+function getPlusFileValueConfigName(filePath) {
+    if (!isPlusFile(filePath))
+        return null;
+    const fileName = path.posix.basename(filePath);
+    // assertNoUnexpectedPlusSign(filePath, fileName)
+    const basename = fileName.split('.')[0];
+    assert(basename.startsWith('+'));
+    const configName = basename.slice(1);
+    assertUsage(configName !== '', `${filePath} Invalid filename ${fileName}`);
+    return configName;
+}
+/* https://github.com/vikejs/vike/issues/1407
+function assertNoUnexpectedPlusSign(filePath: string, fileName: string) {
+  const dirs = path.posix.dirname(filePath).split('/')
+  dirs.forEach((dir, i) => {
+    const dirPath = dirs.slice(0, i + 1).join('/')
+    assertUsage(
+      !dir.includes('+'),
+      `Character '+' is a reserved character: remove '+' from the directory name ${dirPath}/`
+    )
+  })
+  assertUsage(
+    !fileName.slice(1).includes('+'),
+    `Character '+' is only allowed at the beginning of filenames: make sure ${filePath} doesn't contain any '+' in its filename other than its first letter`
+  )
+}
+*/

package/dist/node/vite/shared/resolveVikeConfigInternal/{getPlusFilesByLocationId.d.ts → getPlusFiles.d.ts}

@@ -1,4 +1,4 @@
-export { getPlusFilesByLocationId };
+export { getPlusFiles };
 export { getPlusFileFromConfigFile };
 export type { PlusFileValue };
 export type { PlusFile };
@@ -40,5 +40,5 @@ type PlusFileValue = PlusFileCommon & {
     isExtensionConfig?: undefined;
 };
 type PlusFilesByLocationId = Record<LocationId, PlusFile[]>;
-declare function getPlusFilesByLocationId(userRootDir: string, esbuildCache: EsbuildCache): Promise<PlusFilesByLocationId>;
+declare function getPlusFiles(userRootDir: string, esbuildCache: EsbuildCache): Promise<PlusFilesByLocationId>;
 declare function getPlusFileFromConfigFile(configFile: ConfigFile, isExtensionConfig: boolean, locationId: LocationId, userRootDir: string): PlusFileConfig;