@batijs/cli 0.0.653 → 0.0.655

package/dist/boilerplates/@batijs/shared/bati.config.mjs

@@ -3,7 +3,7 @@ function e(e, t) {
 	if (!e) throw Error(t);
 }
 function t(t) {
-	return `enforce` in t && e(t.enforce === `pre` || t.enforce === `post`, `'enforce' must be 'pre' or 'post', was ${t.enforce}`), `if` in t && e(typeof t.if == `function`, `'if' must be a function`), `nextSteps` in t && e(typeof t.nextSteps == `function`, `'nextSteps' must be a function`), `knip` in t && (e(typeof t.knip == `object` && t.knip !== null, `'knip' must be an object`), `entry` in t.knip && e(Array.isArray(t.knip.entry), `'knip.entry' must be an array`), `ignoreDependencies` in t.knip && e(Array.isArray(t.knip.ignoreDependencies), `'knip.ignoreDependencies' must be an array`), `ignore` in t.knip && e(Array.isArray(t.knip.ignore), `'knip.ignore' must be an array`), `vite` in t.knip && e(typeof t.knip.vite == `boolean`, `'knip.vite' must be a boolean`)), `env` in t && e(typeof t.env == `function`, `'env' must be a function of meta`), `deploy` in t && e(Array.isArray(t.deploy) || typeof t.deploy == `function`, `'deploy' must be an array or a function of meta`), t;
+	return `enforce` in t && e(t.enforce === `pre` || t.enforce === `post`, `'enforce' must be 'pre' or 'post', was ${t.enforce}`), `if` in t && e(typeof t.if == `function`, `'if' must be a function`), `nextSteps` in t && e(typeof t.nextSteps == `function`, `'nextSteps' must be a function`), `knip` in t && (e(typeof t.knip == `object` && t.knip !== null, `'knip' must be an object`), `entry` in t.knip && e(Array.isArray(t.knip.entry), `'knip.entry' must be an array`), `ignoreDependencies` in t.knip && e(Array.isArray(t.knip.ignoreDependencies), `'knip.ignoreDependencies' must be an array`), `ignore` in t.knip && e(Array.isArray(t.knip.ignore), `'knip.ignore' must be an array`), `vite` in t.knip && e(typeof t.knip.vite == `boolean`, `'knip.vite' must be a boolean`)), `env` in t && e(typeof t.env == `function`, `'env' must be a function of meta`), `deploy` in t && e(Array.isArray(t.deploy) || typeof t.deploy == `function`, `'deploy' must be an array or a function of meta`), `skills` in t && e(typeof t.skills == `function`, `'skills' must be a function of meta`), t;
 }
 //#endregion
 //#region bati.config.ts
@@ -12,6 +12,99 @@ var bati_config_default = t({
 	knip: {
 		ignore: ["*.spec.ts"],
 		ignoreDependencies: ["@batijs/tests-utils", "turbo"]
+	},
+	skills(meta) {
+		const pageFile = meta.BATI.has("vue") ? "+Page.vue" : "+Page.tsx";
+		const uiPkg = meta.BATI.has("vue") ? "vike-vue" : meta.BATI.has("solid") ? "vike-solid" : "vike-react";
+		return [
+			{
+				name: "vike-routing",
+				description: "How to add pages and routes in this Vike app. Use when creating a page, adding a route, route parameters, a layout, or an error page.",
+				body: `Routing is file-based under \`pages/\`.
+
+- A route is a directory containing a \`${pageFile}\` component, e.g. \`pages/about/${pageFile}\` → \`/about\`.
+- The index route is \`pages/index/${pageFile}\` → \`/\`.
+- **Parameterized routes:** add a \`+route.ts\` exporting a Route String (e.g. \`"/product/@id"\`); read the value from \`pageContext.routeParams\`.
+- **Layouts / wrappers:** add \`+Layout.*\` (nested layout) or \`+Wrapper.*\` beside or above a page.
+- **Error page:** \`pages/_error/+Page.*\` renders 404s and runtime errors.
+
+See https://vike.dev/routing.`
+			},
+			{
+				name: "vike-data-fetching",
+				description: "How to load data for a page in this Vike app. Use when a page needs server or client data, or you're working with +data / useData.",
+				body: `- Add a \`+data.ts\` beside the page's component and export a \`data()\` function. It runs on the server (and on the client during client-side navigation) and receives \`pageContext\`.
+- Read the result in the component with \`useData<DataType>()\` (from \`${uiPkg}\`).
+- Only values listed in the \`passToClient\` config are serialized to the client; \`+data\` results are passed automatically.
+- For request-time logic such as auth checks or redirects, use a \`+guard.ts\`.
+
+See https://vike.dev/data.`
+			},
+			{
+				name: "vike-config",
+				description: "How Vike configuration works in this app. Use when changing global or per-route config, the page title/head, prerendering, or SSR settings.",
+				body: `- \`+config.ts\` files configure Vike. A \`+config.ts\` directly under \`pages/\` is global; one inside a route directory applies to that route and its descendants.
+- Set the document title and meta tags via \`+Head.*\`, \`+title\`, and \`+description\`.
+- UI-framework integration is provided by \`${uiPkg}\` (already configured).
+- Toggle SSR / prerendering via the \`ssr\` / \`prerender\` settings in \`+config.ts\`.
+
+See https://vike.dev/config.`
+			},
+			{
+				name: "vike-navigation",
+				description: "How to navigate between pages in this Vike app. Use when adding links, redirecting, navigating programmatically, or prefetching.",
+				body: `- **Links:** plain \`<a href="/...">\` works — Vike intercepts it for client-side navigation. Highlight the active link by comparing \`pageContext.urlPathname\` (see the \`vike-pagecontext\` skill).
+- **Programmatic:** \`import { navigate } from "vike/client/router"\`, then \`await navigate("/path", { keepScrollPosition })\`.
+- **Redirect:** in a \`+guard.ts\` or \`+data.ts\`, \`import { redirect } from "vike/abort"\`, then \`throw redirect("/login")\`.
+- **Prefetch:** set \`+prefetchStaticAssets\` to \`"hover"\` / \`"viewport"\` in config, or call \`prefetch("/path")\` from \`vike/client/router\`.
+
+See https://vike.dev/navigate.`
+			},
+			{
+				name: "vike-render-modes",
+				description: "How rendering modes work in this Vike app (SSR / SSG / SPA / streaming). Use when changing how a page is rendered or pre-rendered.",
+				body: `Set these in a \`+config.ts\` (global under \`pages/\`, or per-route):
+- **\`ssr\`** — \`true\` (default) renders on the server then hydrates; \`false\` makes the page client-only (SPA).
+- **\`prerender\`** — \`true\` builds the page to static HTML at build time (SSG). For parameterized routes (\`/movie/@id\`), add a \`+onBeforePrerenderStart.ts\` returning the list of URLs to pre-render.
+- **\`stream\`** — toggle HTML streaming.
+
+See https://vike.dev/pre-rendering.`
+			},
+			{
+				name: "vike-pagecontext",
+				description: "How to use pageContext in this Vike app. Use when reading request/route info in a component or passing custom values to the client.",
+				body: `\`pageContext\` carries request + render info — common props: \`routeParams\`, \`urlPathname\` / \`urlParsed\`, \`data\` (from \`+data\`), \`isClientSide\`.
+- **Read it in a component:** \`import { usePageContext } from "${uiPkg}/usePageContext"\`, then \`const pageContext = usePageContext()\`.
+- **Custom values:** set them on \`pageContext\` from a hook (\`+onBeforeRender\` or \`+data\`), and add their names to \`+passToClient\` so they reach the browser.
+- **Types:** \`PageContext\` / \`PageContextServer\` / \`PageContextClient\` from \`vike/types\`.
+
+See https://vike.dev/pageContext.`
+			},
+			{
+				name: "vike-hooks",
+				description: "The Vike hook system in this app. Use when you need a lifecycle hook — data orchestration, page-transition effects, post-hydration setup, or global init.",
+				body: `Hooks are \`+<name>.ts\` files (or keys in \`+config.ts\`) placed beside a page or globally under \`pages/\`. App-level hooks:
+- **\`+onBeforeRender\`** (server) — advanced data orchestration; can set any \`pageContext\` prop.
+- **\`+onPageTransitionStart\` / \`+onPageTransitionEnd\`** (client) — run around client-side navigation (e.g. a loading indicator); \`pageContext.isBackwardNavigation\` is available.
+- **\`+onHydrationEnd\`** (client) — runs once after the first page hydrates; good for third-party / DOM-only init.
+- **\`+onCreateGlobalContext\`** (server & client) — runs once when the global context is created; global / auth / store init.
+- \`+data\` and \`+guard\` are the common data/auth hooks (see the \`vike-data-fetching\` skill); \`+onBeforePrerenderStart\` lists URLs for SSG (see \`vike-render-modes\`).
+- \`+onRenderHtml\` / \`+onRenderClient\` / \`+onCreateApp\` are provided by \`${uiPkg}\` — you rarely write these.
+
+See https://vike.dev/hooks.`
+			},
+			{
+				name: "vike-error-pages",
+				description: "How error pages work in this Vike app. Use when handling 404s, access errors, or rendering an error page by status code.",
+				body: `The error page is \`pages/_error/${pageFile}\` — Vike renders it for 404s and uncaught errors.
+- **Trigger it:** \`import { render } from "vike/abort"\`, then \`throw render(404)\` (or \`401\` / \`403\` / \`500\`), optionally \`throw render(403, "Forbidden")\` to pass a reason. Use \`throw redirect("/login")\` (from \`vike/abort\`) to redirect instead.
+- **Read the error** in \`_error\`: \`const { abortStatusCode, abortReason, is404 } = usePageContext()\` (from \`${uiPkg}/usePageContext\`).
+- **Custom reason type:** augment \`Vike.PageContext\` with \`abortReason\` in a \`.d.ts\`.
+- Pre-rendering emits the error page as \`dist/client/404.html\`.
+
+See https://vike.dev/error-page.`
+			}
+		];
 	}
 });
 //#endregion

package/dist/boilerplates/@batijs/shared-agents/bati.config.mjs

@@ -0,0 +1,17 @@
+//#region ../../packages/core/dist/config.js
+function e(e, t) {
+	if (!e) throw Error(t);
+}
+function t(t) {
+	return `enforce` in t && e(t.enforce === `pre` || t.enforce === `post`, `'enforce' must be 'pre' or 'post', was ${t.enforce}`), `if` in t && e(typeof t.if == `function`, `'if' must be a function`), `nextSteps` in t && e(typeof t.nextSteps == `function`, `'nextSteps' must be a function`), `knip` in t && (e(typeof t.knip == `object` && t.knip !== null, `'knip' must be an object`), `entry` in t.knip && e(Array.isArray(t.knip.entry), `'knip.entry' must be an array`), `ignoreDependencies` in t.knip && e(Array.isArray(t.knip.ignoreDependencies), `'knip.ignoreDependencies' must be an array`), `ignore` in t.knip && e(Array.isArray(t.knip.ignore), `'knip.ignore' must be an array`), `vite` in t.knip && e(typeof t.knip.vite == `boolean`, `'knip.vite' must be a boolean`)), `env` in t && e(typeof t.env == `function`, `'env' must be a function of meta`), `deploy` in t && e(Array.isArray(t.deploy) || typeof t.deploy == `function`, `'deploy' must be an array or a function of meta`), `skills` in t && e(typeof t.skills == `function`, `'skills' must be a function of meta`), t;
+}
+//#endregion
+//#region bati.config.ts
+var bati_config_default = t({
+	enforce: "post",
+	if(meta) {
+		return meta.BATI.hasAiAgent;
+	}
+});
+//#endregion
+export { bati_config_default as default };

package/dist/boilerplates/@batijs/shared-agents/hooks/after.mjs

@@ -0,0 +1,15 @@
+import { buildAgentsMd } from "./asset-boilerplates/shared-agents/agents-md.mjs";
+import { composeAgentFiles } from "./asset-boilerplates/shared-agents/compose.mjs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+//#region hooks/after.ts
+async function onafter(cwd, meta, { skills, env }) {
+	const agentFiles = composeAgentFiles(meta, skills, buildAgentsMd(meta, env.length > 0));
+	for (const { path, content } of agentFiles) {
+		const dest = join(cwd, path);
+		await mkdir(dirname(dest), { recursive: true });
+		await writeFile(dest, content, "utf-8");
+	}
+}
+//#endregion
+export { onafter as default };

package/dist/boilerplates/@batijs/shared-agents/hooks/asset-boilerplates/shared-agents/agents-md.mjs

@@ -0,0 +1,70 @@
+import { features } from "../../asset-packages/features/dist/features-CStxEDu3.mjs";
+import { categories } from "../../asset-packages/features/dist/index.mjs";
+//#region agents-md.ts
+/**
+* The canonical `AGENTS.md` body (SKILLS_PLAN.md §3/§6.A): the always-loaded project guide —
+* orientation, commands, env, structure — composed from the resolved stack. Kept lean, pointing at
+* `README.md` and upstream docs rather than duplicating volatile detail.
+*/
+function buildAgentsMd(meta, hasEnv) {
+	const run = meta.BATI.pmRun;
+	const sections = [
+		`# AGENTS.md
+
+Guidance for AI coding agents working in this repository. This is a [Vike](https://vike.dev) app
+scaffolded with [Bati](https://batijs.dev). Match the existing conventions and the stack below.`,
+		stackSection(meta),
+		`## Commands
+
+- \`${run} dev\` — start the development server
+- \`${run} build\` — build for production
+- \`${run} preview\` — preview the production build
+
+Use \`${meta.BATI.pm}\` for package management. See \`package.json\` for the full list of scripts.`
+	];
+	if (hasEnv) sections.push(environmentSection(meta));
+	sections.push(structureSection(meta));
+	sections.push(`## Notes for agents
+
+- Respect the selected stack above; prefer its idioms over introducing new libraries.
+- Task-specific how-tos are provided as skills under \`.agents/skills/\` (and \`.claude/skills/\`) — consult them when relevant.
+- See \`README.md\` for setup and feature-specific notes.`);
+	sections.push(referencesSection(meta));
+	return `${sections.join("\n\n")}\n`;
+}
+/** `llms.txt` docs indexes for the selected stack (Vike is the always-present foundation). */
+function referencesSection(meta) {
+	const refs = [];
+	for (const f of features) {
+		const { llms } = f;
+		if (llms && f.category !== "AI Agent" && (f.flag === "vike" || meta.BATI.has(f.flag))) refs.push(`- ${f.label} — ${llms}`);
+	}
+	return `## References
+
+LLM-friendly docs (\`llms.txt\`) for this stack — fetch these for authoritative, up-to-date API details:
+
+${refs.join("\n")}`;
+}
+/** Selected features grouped by category (excluding the AI agents themselves), in category order. */
+function stackSection(meta) {
+	const byCategory = /* @__PURE__ */ new Map();
+	for (const f of features) {
+		if (f.category === "AI Agent" || !meta.BATI.has(f.flag)) continue;
+		byCategory.set(f.category, [...byCategory.get(f.category) ?? [], f.label]);
+	}
+	return `## Stack\n\n${categories.filter((c) => byCategory.has(c.label)).map((c) => `- **${c.label}:** ${byCategory.get(c.label).join(", ")}`).join("\n")}`;
+}
+function environmentSection(meta) {
+	const lines = ["- Client/build-time vars use the `PUBLIC_ENV__*` prefix (read via `import.meta.env`); everything else is server-only."];
+	if (meta.BATI.hasDotEnvSecrets) lines.unshift("- Environment variables are configured in `.env` (dev defaults are committed there); keep real secrets out of version control.");
+	else lines.unshift("- Non-secret vars live in `wrangler.jsonc` (`vars`); set secrets with `wrangler secret put <NAME>`. `.env` holds public/dev values only.");
+	return `## Environment\n\n${lines.join("\n")}`;
+}
+function structureSection(meta) {
+	const lines = ["- `pages/` — file-based routing. A route is a directory with a `+Page` file; add `+route`, `+data`, `+config`, `+guard`, or `+Layout` files beside it. See https://vike.dev.", "- `+config.ts` — Vike configuration (global under `pages/`, or per-route)."];
+	if (meta.BATI.hasServer) lines.push("- The app runs behind a server; the server entry boots Vike (see the `dev` script in `package.json`).");
+	if (meta.BATI.hasDatabase || meta.BATI.hasOrm) lines.push("- Database access lives in the project's db modules; check the schema/migration files and `package.json`.");
+	return `## Project structure\n\n${lines.join("\n")}`;
+}
+//#endregion
+export { buildAgentsMd };

package/dist/boilerplates/@batijs/shared-agents/hooks/asset-boilerplates/shared-agents/compose.mjs

@@ -0,0 +1,44 @@
+import { resolveInstructionFiles, resolveSkillDirs } from "../../asset-packages/features/dist/index.mjs";
+//#region compose.ts
+/**
+* Materialize the agent files for a scaffold (SKILLS_PLAN.md §3/§4): every skill written to each
+* minimal skills dir, plus the canonical `AGENTS.md` (= `agentsBody`) and its `@AGENTS.md` shims.
+* Output order is deterministic (canonical agent order; skills sorted by name) for stable snapshots.
+*/
+function composeAgentFiles(meta, skills, agentsBody) {
+	assertUniqueNames(skills);
+	const selected = meta.BATI.aiAgents;
+	const sortedSkills = [...skills].sort((a, b) => a.name.localeCompare(b.name));
+	const files = [];
+	for (const dir of resolveSkillDirs(selected)) for (const skill of sortedSkills) files.push({
+		path: `${dir}/${skill.name}/SKILL.md`,
+		content: renderSkillMd(skill)
+	});
+	for (const target of resolveInstructionFiles(selected)) files.push({
+		path: target.path,
+		content: target.import === null ? ensureTrailingNewline(agentsBody) : `${target.import}\n`
+	});
+	return files;
+}
+/** Serialize a skill to a `SKILL.md` document (YAML frontmatter + body). */
+function renderSkillMd(skill) {
+	const frontmatter = [`name: ${yamlString(skill.name)}`, `description: ${yamlString(skill.description)}`];
+	if (skill.allowedTools?.length) frontmatter.push(`allowed-tools: [${skill.allowedTools.map(yamlString).join(", ")}]`);
+	return `---\n${frontmatter.join("\n")}\n---\n\n${ensureTrailingNewline(skill.body)}`;
+}
+function assertUniqueNames(skills) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const { name } of skills) {
+		if (seen.has(name)) throw new Error(`Duplicate skill name '${name}' — skill names must be unique.`);
+		seen.add(name);
+	}
+}
+function ensureTrailingNewline(s) {
+	return s.endsWith("\n") ? s : `${s}\n`;
+}
+/** Double-quote and escape so the colons/brackets common in descriptions stay YAML-safe. */
+function yamlString(s) {
+	return `"${s.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
+}
+//#endregion
+export { composeAgentFiles };