@helloleo/plugins 0.2.5 → 0.2.7

package/dist/index.js

@@ -24905,19 +24905,25 @@ var SCAFFOLD_TEMPLATES = {
   "tanstack-router": "tanstack-router-2026-06-15"
 };
 var SCAFFOLD_VERSION = SCAFFOLD_TEMPLATES["tanstack-start"];
+function resolveTemplateId() {
+  const version3 = process.env.SCAFFOLD_VERSION;
+  const known = Object.values(SCAFFOLD_TEMPLATES);
+  if (version3 && known.includes(version3))
+    return version3;
+  return SCAFFOLD_TEMPLATES["tanstack-router"];
+}
 function projectUuidFromDir(dir) {
   return path3.basename(dir);
 }
 var scaffoldOptionsSchema = exports_external2.object({
   name: exports_external2.string().describe("Human-readable name for SEO, e.g. 'Shipping Platform'"),
-  description: exports_external2.string().describe("One sentence describing the app. Used as the meta description."),
-  type: exports_external2.enum(["tanstack-start", "tanstack-router"]).optional().describe("Project type. 'tanstack-router': " + "client-only SPA with no server and no database \u2014 use it only for " + "pure frontends that talk to external APIs." + "'tanstack-start': SSR app with API routes and a " + "database, KV and bucket \u2014 use it whenever the app " + "needs to persist data or run server-side code (experimental, " + "use only if the user expresses a really complexe application idea).")
+  description: exports_external2.string().describe("One sentence describing the app. Used as the meta description.")
 });
 function slugify(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "leo-project";
 }
-async function writeBaseScaffold({ name, description, type }, dir) {
-  const templateId = SCAFFOLD_TEMPLATES[type ?? "tanstack-start"];
+async function writeBaseScaffold({ name, description }, dir) {
+  const templateId = resolveTemplateId();
   const created = await renderTemplate(templateId, {
     LEO_NAME: name,
     LEO_SLUG: slugify(name),
@@ -24930,18 +24936,17 @@ async function writeBaseScaffold({ name, description, type }, dir) {
   return [...created, leoPath];
 }
 var scaffold = tool({
-  description: "Scaffold a new project with React 19, file-based routing (TanStack), " + "Tailwind v4, shadcn/ui, and react-query. Two types: 'tanstack-start' " + "(SSR, API routes, and a database, KV and bucket via @helloleo/runtime) " + "or 'tanstack-router' (client-only SPA, no server, no database). Call " + "this first for any new project, before writing routes or components.",
+  description: "Scaffold a new project with React 19, file-based routing (TanStack), " + "Tailwind v4, shadcn/ui, and react-query. Call this first for any new" + " project, before writing routes or components.",
   args: {
     name: scaffoldOptionsSchema.shape.name,
-    description: scaffoldOptionsSchema.shape.description,
-    type: scaffoldOptionsSchema.shape.type
+    description: scaffoldOptionsSchema.shape.description
   },
   async execute(args, context) {
-    const type = args.type ?? "tanstack-start";
+    const isStart = resolveTemplateId() === SCAFFOLD_TEMPLATES["tanstack-start"];
     const created = await writeBaseScaffold(args, context.directory);
     const uiComponents = created.filter((f) => f.startsWith("src/components/ui/"));
     const rest = created.filter((f) => !f.startsWith("src/components/ui/"));
-    const typeNotes = type === "tanstack-start" ? [
+    const typeNotes = isStart ? [
       "- This is a TanStack Start project. The server entry is src/server.ts. There is no index.html or client entrypoint.",
       "- For JSON/CRUD APIs, add server routes under src/routes/api/. Read src/routes/api/health.ts first, add routes as needed.",
       "- The database schema lives in src/db/schema.ts. Migrations run automatically."
@@ -24949,7 +24954,7 @@ var scaffold = tool({
       "- This is a TanStack Router SPA. The client entry is index.html -> src/main.tsx. There is no server: no API routes, no server functions, no database.",
       "- Fetch data from external APIs only. If the app needs its own persistence or server-side code, it should have been scaffolded as tanstack-start."
     ];
-    const nextSteps = type === "tanstack-start" ? [
+    const nextSteps = isStart ? [
       "Next: read src/routes/index.tsx and continue with the user's request.",
       "For authentication (password and/or OAuth), call setup_authentication.",
       "For NetSuite projects, call setup_netsuite."

package/dist/templates/tanstack-router-2026-06-15/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "{{LEO_NAME}}",
+  "name": "{{LEO_SLUG}}",
   "private": true,
   "type": "module",
   "imports": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helloleo/plugins",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "OpenCode plugins for HelloLeo",
   "license": "UNLICENSED",
   "type": "module",

package/src/templates/tanstack-router-2026-06-15/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "{{LEO_NAME}}",
+  "name": "{{LEO_SLUG}}",
   "private": true,
   "type": "module",
   "imports": {

package/src/tools/scaffold.ts

@@ -27,6 +27,19 @@ export type ScaffoldType = keyof typeof SCAFFOLD_TEMPLATES;
 /** Default template id, kept for callers that predate the `type` param. */
 export const SCAFFOLD_VERSION = SCAFFOLD_TEMPLATES["tanstack-start"];
 
+/**
+ * The container can pin the template via SCAFFOLD_VERSION (a versioned
+ * template id, e.g. "tanstack-start-2026-06-18"). Unset or unknown values
+ * fall back to the tanstack-router template, so a stale env var can never
+ * reproduce the ENOENT-on-missing-template failure.
+ */
+export function resolveTemplateId(): string {
+	const version = process.env.SCAFFOLD_VERSION;
+	const known: string[] = Object.values(SCAFFOLD_TEMPLATES);
+	if (version && known.includes(version)) return version;
+	return SCAFFOLD_TEMPLATES["tanstack-router"];
+}
+
 /**
  * The project workspace directory is named after the project UUID -- the
  * webapp generates `<slugified-name>-<uuidv4>` (actions.ts createProject)
@@ -45,18 +58,18 @@ const scaffoldOptionsSchema = z.object({
 	description: z
 		.string()
 		.describe("One sentence describing the app. Used as the meta description."),
-	type: z
-		.enum(["tanstack-start", "tanstack-router"])
-		.optional()
-		.describe(
-			"Project type. 'tanstack-router': " +
-				"client-only SPA with no server and no database — use it only for " +
-				"pure frontends that talk to external APIs." +
-				"'tanstack-start': SSR app with API routes and a " +
-				"database, KV and bucket — use it whenever the app " +
-				"needs to persist data or run server-side code (experimental, " +
-				"use only if the user expresses a really complexe application idea).",
-		),
+	// type: z
+	// 	.enum(["tanstack-start", "tanstack-router"])
+	// 	.optional()
+	// 	.describe(
+	// 		"Project type. 'tanstack-router': " +
+	// 			"client-only SPA with no server and no database — use it only for " +
+	// 			"pure frontends that talk to external APIs." +
+	// 			"'tanstack-start': SSR app with API routes and a " +
+	// 			"database, KV and bucket — use it whenever the app " +
+	// 			"needs to persist data or run server-side code (experimental, " +
+	// 			"use only if the user expresses a really complexe application idea).",
+	// 	),
 });
 
 /** Kebab-case slug of the product name, for package.json. */
@@ -75,10 +88,10 @@ function slugify(name: string): string {
  * not part of the template tree). Returns the relative paths written.
  */
 export async function writeBaseScaffold(
-	{ name, description, type }: z.infer<typeof scaffoldOptionsSchema>,
+	{ name, description }: z.infer<typeof scaffoldOptionsSchema>,
 	dir: string,
 ): Promise<string[]> {
-	const templateId = SCAFFOLD_TEMPLATES[type ?? "tanstack-start"];
+	const templateId = resolveTemplateId();
 	const created = await renderTemplate(
 		templateId,
 		{
@@ -103,45 +116,41 @@ export async function writeBaseScaffold(
 export const scaffold = tool({
 	description:
 		"Scaffold a new project with React 19, file-based routing (TanStack), " +
-		"Tailwind v4, shadcn/ui, and react-query. Two types: 'tanstack-start' " +
-		"(SSR, API routes, and a database, KV and bucket via @helloleo/runtime) " +
-		"or 'tanstack-router' (client-only SPA, no server, no database). Call " +
-		"this first for any new project, before writing routes or components.",
+		"Tailwind v4, shadcn/ui, and react-query. Call this first for any new" +
+		" project, before writing routes or components.",
 	args: {
 		name: scaffoldOptionsSchema.shape.name,
 		description: scaffoldOptionsSchema.shape.description,
-		type: scaffoldOptionsSchema.shape.type,
 	},
 	async execute(args, context) {
-		const type: ScaffoldType = args.type ?? "tanstack-start";
+		const isStart =
+			resolveTemplateId() === SCAFFOLD_TEMPLATES["tanstack-start"];
 		const created = await writeBaseScaffold(args, context.directory);
 		const uiComponents = created.filter((f) =>
 			f.startsWith("src/components/ui/"),
 		);
 		const rest = created.filter((f) => !f.startsWith("src/components/ui/"));
 
-		const typeNotes =
-			type === "tanstack-start"
-				? [
-						"- This is a TanStack Start project. The server entry is src/server.ts. There is no index.html or client entrypoint.",
-						"- For JSON/CRUD APIs, add server routes under src/routes/api/. Read src/routes/api/health.ts first, add routes as needed.",
-						"- The database schema lives in src/db/schema.ts. Migrations run automatically.",
-					]
-				: [
-						"- This is a TanStack Router SPA. The client entry is index.html -> src/main.tsx. There is no server: no API routes, no server functions, no database.",
-						"- Fetch data from external APIs only. If the app needs its own persistence or server-side code, it should have been scaffolded as tanstack-start.",
-					];
+		const typeNotes = isStart
+			? [
+					"- This is a TanStack Start project. The server entry is src/server.ts. There is no index.html or client entrypoint.",
+					"- For JSON/CRUD APIs, add server routes under src/routes/api/. Read src/routes/api/health.ts first, add routes as needed.",
+					"- The database schema lives in src/db/schema.ts. Migrations run automatically.",
+				]
+			: [
+					"- This is a TanStack Router SPA. The client entry is index.html -> src/main.tsx. There is no server: no API routes, no server functions, no database.",
+					"- Fetch data from external APIs only. If the app needs its own persistence or server-side code, it should have been scaffolded as tanstack-start.",
+				];
 
-		const nextSteps =
-			type === "tanstack-start"
-				? [
-						"Next: read src/routes/index.tsx and continue with the user's request.",
-						"For authentication (password and/or OAuth), call setup_authentication.",
-						"For NetSuite projects, call setup_netsuite.",
-					]
-				: [
-						"Next: read src/routes/index.tsx and continue with the user's request.",
-					];
+		const nextSteps = isStart
+			? [
+					"Next: read src/routes/index.tsx and continue with the user's request.",
+					"For authentication (password and/or OAuth), call setup_authentication.",
+					"For NetSuite projects, call setup_netsuite.",
+				]
+			: [
+					"Next: read src/routes/index.tsx and continue with the user's request.",
+				];
 
 		return [
 			`Scaffolded ${created.length} files:`,

package/dist/templates/tanstack-router-2026-06-15/src/router.tsx

@@ -1,23 +0,0 @@
-import { QueryClient } from '@tanstack/react-query'
-import { createRouter as createTanStackRouter } from '@tanstack/react-router'
-import { routeTree } from './routeTree.gen'
-
-export function getRouter() {
-  const queryClient = new QueryClient()
-
-  const router = createTanStackRouter({
-    routeTree,
-    context: { queryClient },
-    scrollRestoration: true,
-    defaultPreload: 'intent',
-    defaultPreloadStaleTime: 0,
-  })
-
-  return router
-}
-
-declare module '@tanstack/react-router' {
-  interface Register {
-    router: ReturnType<typeof getRouter>
-  }
-}

package/src/templates/tanstack-router-2026-06-15/src/router.tsx

@@ -1,23 +0,0 @@
-import { QueryClient } from '@tanstack/react-query'
-import { createRouter as createTanStackRouter } from '@tanstack/react-router'
-import { routeTree } from './routeTree.gen'
-
-export function getRouter() {
-  const queryClient = new QueryClient()
-
-  const router = createTanStackRouter({
-    routeTree,
-    context: { queryClient },
-    scrollRestoration: true,
-    defaultPreload: 'intent',
-    defaultPreloadStaleTime: 0,
-  })
-
-  return router
-}
-
-declare module '@tanstack/react-router' {
-  interface Register {
-    router: ReturnType<typeof getRouter>
-  }
-}