@beignet/cli 0.0.21 → 0.0.23

package/src/templates/agents.ts

@@ -52,8 +52,9 @@ is a silent failure — the file exists but never runs:
 
 The starter ships no workflow registries — generators create them on first
 use, so their absence is fine. \`${cli} make event\`, \`${cli} make job\`,
-\`${cli} make schedule\`, \`${cli} make task\`, \`${cli} make seed\`, and
-\`${cli} make upload\` create or update their required app entrypoints.
+\`${cli} make listener\`, \`${cli} make schedule\`, \`${cli} make task\`,
+\`${cli} make seed\`, and \`${cli} make upload\` create or update their
+required app entrypoints.
 \`${cli} doctor\` detects registration drift. \`${cli} doctor --fix\` repairs
 route-group, schedule, task, and outbox registration; listener drift is
 report-only and must be fixed by hand.
@@ -62,8 +63,10 @@ report-only and must be fixed by hand.
 
 \`${cli} make <artifact> <name>\` creates correctly placed, pre-registered
 files — prefer it over hand-writing them. See \`${cli} make --help\` for the
-artifact list. After changing the Drizzle schema in \`infra/db/schema/\`, run
-\`${cli} db generate\` then \`${cli} db migrate\`.
+artifact list. Use \`${cli} make feature <name> --recipe full-slice\` when you
+need a richer reference slice with policy, client helpers, workflow artifacts,
+events, listener registration, jobs, and outbox wiring. After changing the Drizzle schema in
+\`infra/db/schema/\`, run \`${cli} db generate\` then \`${cli} db migrate\`.
 
 ## Validation loop
 
@@ -98,7 +101,8 @@ skill-loading block.
 
 - Feature artifacts live under \`features/<feature>/\`, with tests in
   \`features/<feature>/tests/\` (not \`__tests__/\`).
-- Feature-specific client data-fetching helpers and hooks may live in
+- Feature-specific client data-fetching helpers, query options, mutation
+  options, invalidation helpers, and hooks live in
   \`features/<feature>/client/\`; shared client setup stays in root \`client/\`.
 - Domain and use-case code must not import infra, providers, or React.
 - Routes must not import concrete infra.

package/src/templates/base.ts

@@ -273,6 +273,7 @@ ${cli} doctor
 \`\`\`
 
 \`make feature\` creates a contract-to-test vertical slice with Drizzle schema and repository files, so regenerate and migrate the database before running the app against the new feature.
+Use \`${cli} make feature projects --recipe full-slice\` when you want a richer reference slice with policy, feature client helpers, workflow artifacts, events, listener registration, jobs, and outbox wiring.
 
 ## App map
 

package/src/templates/index.ts

@@ -58,6 +58,7 @@ export function getTemplateFiles(ctx: TemplateContext): TemplateFile[] {
       content: serverFiles.apiCatchAllRoute,
     },
     { path: "app/api/health/route.ts", content: serverFiles.healthRoute },
+    { path: "app/api/ready/route.ts", content: serverFiles.readyRoute },
     {
       path: "app/api/devtools/[[...path]]/route.ts",
       content: serverFiles.devtoolsRoute,

package/src/templates/server.ts

@@ -515,6 +515,33 @@ export function GET() {
 		},
 	);
 }
+`,
+  readyRoute: `import { createHealthHandler } from "@beignet/core/server";
+import { env } from "@/lib/env";
+import { server } from "@/server";
+
+const readiness = createHealthHandler(
+	server.ports,
+	{
+		checks: {
+			database: (ports) => ports.db.checkHealth(),
+		},
+		timeoutMs: 2000,
+	},
+	env.NODE_ENV,
+);
+
+export async function GET(request: Request) {
+	const response = await readiness(request);
+
+	return Response.json(response.body, {
+		status: response.status,
+		headers: {
+			...response.headers,
+			"cache-control": "no-store",
+		},
+	});
+}
 `,
   devtoolsRoute: `import { createDevtoolsRoute } from "@beignet/devtools";
 import { env } from "@/lib/env";
@@ -578,6 +605,9 @@ export default function RootLayout({ children }: { children: ReactNode }) {
 				<li>
 					<a href="/api/health">/api/health</a> — health check
 				</li>
+				<li>
+					<a href="/api/ready">/api/ready</a> — readiness check
+				</li>
 				<li>
 					<a href="/api/openapi">/api/openapi</a> — OpenAPI document
 				</li>

package/src/templates/shell.ts

@@ -110,6 +110,9 @@ export default function HomePage() {
 					<a className="hover:text-foreground" href="/api/health">
 						Health
 					</a>
+					<a className="hover:text-foreground" href="/api/ready">
+						Ready
+					</a>
 					<a className="hover:text-foreground" href="/api/openapi">
 						OpenAPI
 					</a>
@@ -1032,12 +1035,41 @@ export function SettingsNav() {
 }
 `;
 
+const todoClientQueries = `import type { QueryClient } from "@tanstack/react-query";
+import { rq } from "@/client";
+import {
+	createTodo,
+	deleteTodo,
+	listTodos,
+	updateTodo,
+} from "@/features/todos/contracts";
+
+export function listTodosQueryOptions() {
+	return rq(listTodos).queryOptions();
+}
+
+export function createTodoMutationOptions() {
+	return rq(createTodo).mutationOptions();
+}
+
+export function updateTodoMutationOptions() {
+	return rq(updateTodo).mutationOptions();
+}
+
+export function deleteTodoMutationOptions() {
+	return rq(deleteTodo).mutationOptions();
+}
+
+export function invalidateTodos(queryClient: QueryClient) {
+	return rq(listTodos).invalidate(queryClient);
+}
+`;
+
 const todoApp = `"use client";
 
 import { rootFormError } from "@beignet/react-hook-form";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { Trash2Icon } from "lucide-react";
-import { rq } from "@/client";
 import { rhf } from "@/client/forms";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent } from "@/components/ui/card";
@@ -1045,45 +1077,44 @@ import { Checkbox } from "@/components/ui/checkbox";
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
 import {
-	createTodo,
-	deleteTodo,
-	listTodos,
-	updateTodo,
-} from "@/features/todos/contracts";
+	createTodoMutationOptions,
+	deleteTodoMutationOptions,
+	invalidateTodos,
+	listTodosQueryOptions,
+	updateTodoMutationOptions,
+} from "@/features/todos/client/queries";
+import { createTodo } from "@/features/todos/contracts";
 import { cn } from "@/lib/utils";
 
 const createTodoForm = rhf(createTodo);
 
 export function TodoApp() {
 	const queryClient = useQueryClient();
-	const todosQuery = useQuery(rq(listTodos).queryOptions());
+	const todosQuery = useQuery(listTodosQueryOptions());
 	const form = createTodoForm.useForm({
 		defaultValues: { title: "" },
 	});
 
-	const invalidateTodos = () => rq(listTodos).invalidate(queryClient);
+	const invalidateTodoQueries = () => invalidateTodos(queryClient);
 
-	const createTodoMutation = useMutation(
-		rq(createTodo).mutationOptions({
-			onSuccess: async () => {
-				form.reset();
-				await invalidateTodos();
-			},
-			onError: (error) => {
-				form.setError("root", rootFormError(error, "Could not create the todo."));
-			},
-		}),
-	);
-	const updateTodoMutation = useMutation(
-		rq(updateTodo).mutationOptions({
-			onSuccess: invalidateTodos,
-		}),
-	);
-	const deleteTodoMutation = useMutation(
-		rq(deleteTodo).mutationOptions({
-			onSuccess: invalidateTodos,
-		}),
-	);
+	const createTodoMutation = useMutation({
+		...createTodoMutationOptions(),
+		onSuccess: async () => {
+			form.reset();
+			await invalidateTodoQueries();
+		},
+		onError: (error) => {
+			form.setError("root", rootFormError(error, "Could not create the todo."));
+		},
+	});
+	const updateTodoMutation = useMutation({
+		...updateTodoMutationOptions(),
+		onSuccess: invalidateTodoQueries,
+	});
+	const deleteTodoMutation = useMutation({
+		...deleteTodoMutationOptions(),
+		onSuccess: invalidateTodoQueries,
+	});
 
 	const onSubmit = form.handleSubmit((body) => {
 		form.clearErrors("root");
@@ -1212,6 +1243,10 @@ export function shellTemplateFiles(ctx: TemplateContext): TemplateFile[] {
     { path: "components/theme-toggle.tsx", content: themeToggle },
     { path: "components/app-sidebar.tsx", content: appSidebar },
     { path: "components/settings-nav.tsx", content: settingsNav },
+    {
+      path: "features/todos/client/queries.ts",
+      content: todoClientQueries,
+    },
     {
       path: "features/todos/components/todo-app.tsx",
       content: todoApp,