@askrjs/cli 0.0.2 → 0.0.4

package/dist/templates/full-stack/src/routes.tsx

@@ -1,20 +1,19 @@
-import { createRouteRegistry, group, route } from '@askrjs/askr/router';
-import { actionsFor } from './action-authorizations';
-import { AppLayout } from './pages/layout';
-import { HomePage } from './pages/home';
-import { NotFoundPage } from './pages/not-found';
+import { createRouteRegistry, group, route } from "@askrjs/askr/router";
+import { actionsFor } from "./action-authorizations";
+import { AppLayout } from "./pages/layout";
+import { HomePage } from "./pages/home";
+import { NotFoundPage } from "./pages/not-found";
 
 export const pageRegistry = createRouteRegistry(() => {
   group({ layout: AppLayout }, () => {
-    route('/', HomePage, {
-      actions: actionsFor('/'),
+    route("/", HomePage, {
+      actions: actionsFor("/"),
       meta: {
-        title: '{{appName}}',
-        description: 'A progressive full-stack Askr application.',
-        html: { lang: 'en', dir: 'ltr' },
+        title: "{{appName}}",
+        description: "A progressive full-stack Askr application.",
+        html: { lang: "en", dir: "ltr" },
       },
     });
-    route('/*', NotFoundPage);
+    route("/*", NotFoundPage);
   });
 });
-

package/dist/templates/full-stack/src/schemas.ts

@@ -1,4 +1,4 @@
-import { schema } from '@askrjs/schema';
+import { schema } from "@askrjs/schema";
 
 export const MessageInput = schema.object({
   value: schema.string({ minLength: 1, maxLength: 200 }),
@@ -8,4 +8,3 @@ export const Message = schema.object({
   id: schema.string(),
   value: schema.string(),
 });
-

package/dist/templates/full-stack/src/server/action-registry.ts

@@ -1,12 +1,7 @@
-import { createActionRegistry } from '@askrjs/server/askr';
-import { createMessageAction } from '../actions/create-message';
-import { createMessage } from './actions/create-message';
-import type { AppDependencies } from './dependencies';
+import { handleAction } from "@askrjs/server/askr";
+import { createMessageAction } from "../actions/create-message";
+import { createMessage } from "./actions/create-message";
 
-export function createActions(deps: AppDependencies) {
-  const registry = createActionRegistry(deps, {
-    csrf: { secret: process.env.CSRF_SECRET ?? 'development-only-secret' },
-  });
-  registry.register(createMessageAction, createMessage);
-  return registry;
+export function createActionHandlers() {
+  return [handleAction(createMessageAction, createMessage)] as const;
 }

package/dist/templates/full-stack/src/server/actions/create-message.ts

@@ -1,13 +1,13 @@
-import type { InferSchema } from '@askrjs/schema';
-import { createMessageAction } from '../../actions/create-message';
-import type { AppDependencies } from '../dependencies';
+import type { InferSchema } from "@askrjs/schema";
+import { createMessageAction } from "../../actions/create-message";
+import type { AppDependencies } from "../dependencies";
 
 type Input = InferSchema<typeof createMessageAction.input>;
 
 export async function createMessage(
   _context: unknown,
   input: Input,
-  deps: Pick<AppDependencies, 'actions'>,
+  deps: Pick<AppDependencies, "actions">,
 ) {
   await deps.actions.record({ action: createMessageAction.id, value: input.value });
   return { result: { accepted: true } };

package/dist/templates/full-stack/src/server/app.ts

@@ -1,66 +1,76 @@
-import { createAuth } from '@askrjs/auth';
-import { createServerApp } from '@askrjs/server';
-import { createAskrPageHandler } from '@askrjs/server/askr';
-import { csrf, rateLimit, requestId, securityHeaders } from '@askrjs/server/middleware';
-import { createApi } from '@askrjs/server/openapi';
-import { pageRegistry } from '../routes';
-import { Message, MessageInput } from '../schemas';
-import { telemetry } from '../telemetry';
-import { createActions } from './action-registry';
-import type { AppDependencies } from './dependencies';
+import { createAuth } from "@askrjs/auth";
+import { createAskrApp } from "@askrjs/server/askr";
+import { csrf, rateLimit, requestId, securityHeaders } from "@askrjs/server/middleware";
+import { pageRegistry } from "../routes";
+import { Message, MessageInput } from "../schemas";
+import { telemetry } from "../telemetry";
+import { createActionHandlers } from "./action-registry";
+import type { AppDependencies } from "./dependencies";
 
 export function createApp(deps: AppDependencies) {
-  const api = createApi<AppDependencies>({
-    info: { title: '{{appName}} API', version: '1.0.0' },
-  });
-  api.post('/api/messages', {
-    input: {
-      body: {
-        schema: MessageInput,
-        mediaTypes: ['application/json'],
+  return createAskrApp({
+    name: "{{appName}}",
+    version: "1.0.0",
+    dependencies: deps,
+    pages: pageRegistry,
+    api: {
+      define(api) {
+        api
+          .post("/messages", {
+            input: {
+              body: {
+                schema: MessageInput,
+                mediaTypes: ["application/json"],
+              },
+            },
+            documentation: { body: { required: true } },
+            async handler(ctx, input, dependencies) {
+              const message = { id: crypto.randomUUID(), value: input.body.value };
+              await dependencies.actions.record({
+                action: "api.create-message",
+                value: message.value,
+              });
+              return ctx.created(message);
+            },
+          })
+          .operationId("createMessage")
+          .summary("Create a message")
+          .tags("Messages")
+          .use(
+            csrf({ secret: process.env.CSRF_SECRET ?? "development-only-secret" }),
+            rateLimit({ store: deps.rateLimits, limit: 30, windowMs: 60_000 }),
+          )
+          .created(Message)
+          .badRequest()
+          .unprocessableEntity()
+          .tooManyRequests();
+        api
+          .post("/session", (ctx) => {
+            const response = ctx.redirect("/", 303);
+            return ctx.setCookie(response, "askr-session", "demo-session", {
+              httpOnly: true,
+              sameSite: "lax",
+              secure: ctx.url.protocol === "https:",
+              path: "/",
+            });
+          })
+          .operationId("createSession")
+          .summary("Create a demo session")
+          .seeOther();
       },
     },
-    documentation: { body: { required: true } },
-    async handler(ctx, input, dependencies) {
-      const message = { id: crypto.randomUUID(), value: input.body.value };
-      await dependencies.actions.record({ action: 'api.create-message', value: message.value });
-      return ctx.created(message);
+    auth: {
+      resolver: createAuth({
+        sessions: deps.sessions,
+        principals: deps.principals,
+        sessionCookie: "askr-session",
+      }),
+    },
+    actions: {
+      handlers: createActionHandlers(),
+      csrf: { secret: process.env.CSRF_SECRET ?? "development-only-secret" },
     },
-  })
-    .operationId('createMessage')
-    .summary('Create a message')
-    .tags('Messages')
-    .use(
-      csrf({ secret: process.env.CSRF_SECRET ?? 'development-only-secret' }),
-      rateLimit({ store: deps.rateLimits, limit: 30, windowMs: 60_000 }),
-    )
-    .created(Message)
-    .badRequest()
-    .unprocessableEntity()
-    .tooManyRequests();
-
-  const router = api.createRouter(deps);
-  router.post('/api/session', (ctx) => {
-    const response = ctx.redirect('/', 303);
-    return ctx.setCookie(response, 'askr-session', 'demo-session', {
-      httpOnly: true,
-      sameSite: 'lax',
-      secure: ctx.url.protocol === 'https:',
-      path: '/',
-    });
-  });
-  return createServerApp({
-    router,
-    auth: createAuth({
-      sessions: deps.sessions,
-      principals: deps.principals,
-      sessionCookie: 'askr-session',
-    }),
     middleware: [requestId(), securityHeaders()],
     telemetry,
-    fallback: createAskrPageHandler({
-      registry: pageRegistry,
-      actions: createActions(deps),
-    }),
   });
 }

package/dist/templates/full-stack/src/server/dependencies.ts

@@ -13,7 +13,11 @@ export interface AppDependencies {
     record(entry: { action: string; value: string }): Promise<void>;
   };
   readonly rateLimits: {
-    consume(key: string, limit: number, windowMs: number): Promise<{
+    consume(
+      key: string,
+      limit: number,
+      windowMs: number,
+    ): Promise<{
       allowed: boolean;
       remaining: number;
       reset: number;
@@ -25,23 +29,19 @@ export function createDependencies(): AppDependencies {
   const counters = new Map<string, { count: number; reset: number }>();
   return {
     sessions: {
-      get: async (id) => id === 'demo-session'
-        ? { id, subject: 'demo-user' }
-        : null,
+      get: async (id) => (id === "demo-session" ? { id, subject: "demo-user" } : null),
     },
     principals: {
-      get: async (subject) => subject === 'demo-user'
-        ? { id: subject, subject, permissions: ['messages:create'] }
-        : null,
+      get: async (subject) =>
+        subject === "demo-user" ? { id: subject, subject, permissions: ["messages:create"] } : null,
     },
     actions: { record: async () => undefined },
     rateLimits: {
       async consume(key, limit, windowMs) {
         const now = Date.now();
         const current = counters.get(key);
-        const window = !current || current.reset <= now
-          ? { count: 0, reset: now + windowMs }
-          : current;
+        const window =
+          !current || current.reset <= now ? { count: 0, reset: now + windowMs } : current;
         window.count += 1;
         counters.set(key, window);
         return {

package/dist/templates/full-stack/src/server/entry-server.ts

@@ -1,8 +1,8 @@
-import { createApp } from './app';
-import { createDependencies } from './dependencies';
+import { createApp } from "./app";
+import { createDependencies } from "./dependencies";
 
 const app = createApp(createDependencies());
 
 export { app };
-export { telemetry } from '../telemetry';
+export { telemetry } from "../telemetry";
 export default app;

package/dist/templates/full-stack/src/telemetry.ts

@@ -1,4 +1,3 @@
-import { createTelemetry } from '@askrjs/otel';
+import { createTelemetry } from "@askrjs/otel";
 
 export const telemetry = createTelemetry();
-

package/dist/templates/full-stack/tests/actions/create-message.test.ts

@@ -1,13 +1,12 @@
-import { describe, expect, it } from 'vitest';
-import { createMessageAction } from '../../src/actions/create-message';
+import { describe, expect, it } from "vitest";
+import { createMessageAction } from "../../src/actions/create-message";
 
-describe('create message action', () => {
-  it('should reject an empty message given declared input validation', () => {
-    expect(createMessageAction.input.safeParse({ value: '' }).success).toBe(false);
+describe("create message action", () => {
+  it("should reject an empty message given declared input validation", () => {
+    expect(createMessageAction.input.safeParse({ value: "" }).success).toBe(false);
   });
 
-  it('should accept a message given valid input', () => {
-    expect(createMessageAction.input.safeParse({ value: 'hello' }).success).toBe(true);
+  it("should accept a message given valid input", () => {
+    expect(createMessageAction.input.safeParse({ value: "hello" }).success).toBe(true);
   });
 });
-

package/dist/templates/full-stack/tsconfig.json

@@ -9,8 +9,7 @@
     "noEmit": true,
     "jsx": "preserve",
     "jsxImportSource": "@askrjs/askr",
-    "types": ["vite/client", "node"]
+    "types": ["vite/client", "node", "@askrjs/themes"]
   },
   "include": ["src", "tests", "server.ts", "vite.config.ts"]
 }
-

package/dist/templates/full-stack/vite.config.ts

@@ -1,11 +1,10 @@
-import { defineConfig } from 'vite-plus';
-import { askr } from '@askrjs/vite';
-import { askrServer } from '@askrjs/vite/server';
+import { defineConfig } from "vite-plus";
+import { askr } from "@askrjs/vite";
+import { askrServer } from "@askrjs/vite/server";
 
 export default defineConfig({
-  plugins: [askr(), askrServer({ entry: './src/server/entry-server.ts' })],
-  lint: { ignorePatterns: ['dist/**', 'node_modules/**', 'coverage/**'] },
+  plugins: [askr(), askrServer({ entry: "./src/server/entry-server.ts" })],
+  lint: { ignorePatterns: ["dist/**", "node_modules/**", "coverage/**"] },
   server: { port: 5173, open: true },
   build: { manifest: true, sourcemap: true },
 });
-

package/dist/templates/spa/AGENTS.md

@@ -23,7 +23,7 @@ npm run fmt        # Prettier
 - **Data:** Route/container components own resources; `src/features` owns product workflows; `src/adapters` owns API clients, transports, abort handling, and generated clients.
 - **Consistency:** Event-sourced screens should expose pending writes, projection lag, stale data, retries, and manual refresh instead of hiding everything behind one loading state.
 - **Styling:** Keep `src/styles.css` thin. Customize theme values in `src/styles/tokens.css`, global defaults in `src/styles/theme.css`, shell structure in `src/styles/layout.css`, and component classes in `src/styles/components.css`.
-- **Charts:** Import chart components from `@askrjs/charts/components`; chart CSS is loaded from `@askrjs/charts/default`.
+- **Charts:** Create typed plot namespaces from `@askrjs/charts` at module scope and compose marks inside `Plot.Root`; chart CSS is loaded from `@askrjs/charts/styles`.
 - **Vite plugin:** `askr()` from `@askrjs/vite` handles JSX transform. Do not add manual esbuild JSX config.
 
 ## File Structure

package/dist/templates/spa/package.json

@@ -7,7 +7,7 @@
     "dev": "vp dev",
     "build": "vp build",
     "preview": "vp preview",
-    "test": "vp test run",
+    "test": "vp test run -c ./vitest.config.ts",
     "typecheck": "tsc --noEmit",
     "lint": "vp lint .",
     "lint:fix": "npm run lint -- --fix",
@@ -16,15 +16,14 @@
   },
   "dependencies": {
     "@askrjs/askr": ">=0.0.53 <0.1.0",
-    "@askrjs/charts": ">=0.0.3 <0.1.0",
-    "@askrjs/logos": ">=0.0.3 <0.1.0",
+    "@askrjs/charts": ">=0.1.0 <0.2.0",
     "@askrjs/lucide": ">=0.0.3 <0.1.0",
     "@askrjs/themes": ">=0.0.12 <0.1.0",
     "@askrjs/ui": ">=0.0.13 <0.1.0"
   },
   "devDependencies": {
     "@askrjs/vite": ">=0.0.6 <0.1.0",
-    "@types/node": "^26.0.0",
+    "@types/node": "^20.19.0",
     "jsdom": "^29.1.1",
     "typescript": "^6.0.3",
     "vite-plus": "^0.2.4"

package/dist/templates/spa/src/adapters/operations-client.ts

@@ -8,13 +8,18 @@ export type OperationRun = {
   updatedAt: string;
 };
 
+export type OperationsChartRow = {
+  label: string;
+  value: number;
+};
+
 export type OperationsSnapshot = {
   version: number;
   consistency: 'fresh' | 'pending-write' | 'stale';
   lastEventId: string;
   metrics: Array<{ label: string; value: string; trend: string }>;
-  throughput: Array<{ label: string; value: number }>;
-  lag: Array<{ label: string; value: number }>;
+  throughput: OperationsChartRow[];
+  lag: OperationsChartRow[];
   runs: OperationRun[];
 };
 

package/dist/templates/spa/src/pages/app/_routes.tsx

@@ -2,8 +2,10 @@ import { route } from '@askrjs/askr/router';
 import AgentRunsPage from './agent-runs';
 import AdminHomePage from './admin-home';
 import SettingsPage from './settings';
+// askr:imports
 
 export function registerAppRoutes(): void {
+  // askr:routes
   route('/app', AdminHomePage);
   route('/app/agents', AgentRunsPage);
   route('/app/settings', SettingsPage);

package/dist/templates/spa/src/pages/app/admin-home.tsx

@@ -1,5 +1,5 @@
 import { resource } from '@askrjs/askr/resources';
-import { BarChart, Sparkline } from '@askrjs/charts/components';
+import { createPlot } from '@askrjs/charts';
 import { AlertCircleIcon, RefreshCwIcon } from '@askrjs/lucide';
 import { Button } from '@askrjs/themes/components';
 import {
@@ -16,9 +16,12 @@ import { Block, Inline, Section, Stack } from '@askrjs/themes/components';
 import { EmptyState } from '@askrjs/themes/components';
 import MetricCard from '../../components/shared/metric-card';
 import StatusBadge from '../../components/shared/status-badge';
+import type { OperationsChartRow } from '../../adapters/operations-client';
 import { loadOperations } from '../../features/operations/operations.query';
 import { formatRelativeTime } from '../../shared/format';
 
+const OperationsPlot = createPlot<OperationsChartRow>();
+
 export default function AdminHomePage() {
   const operations = resource(({ signal }) => loadOperations({ signal }), []);
   const snapshot = operations.value;
@@ -84,7 +87,14 @@ export default function AdminHomePage() {
                 </CardDescription>
               </CardHeader>
               <CardContent>
-                <BarChart label="Run throughput" data={snapshot.throughput} />
+                <OperationsPlot.Root
+                  data={snapshot.throughput}
+                  rowKey="label"
+                  label="Run throughput"
+                  description="Accepted commands by work type."
+                >
+                  <OperationsPlot.Bar x="label" y="value" />
+                </OperationsPlot.Root>
               </CardContent>
             </Card>
             <Card>
@@ -95,7 +105,15 @@ export default function AdminHomePage() {
                 </CardDescription>
               </CardHeader>
               <CardContent>
-                <Sparkline label="Projection lag" data={snapshot.lag} />
+                <OperationsPlot.Root
+                  data={snapshot.lag}
+                  rowKey="label"
+                  label="Projection lag"
+                  description="Projection lag over the last hour."
+                >
+                  <OperationsPlot.Line x="label" y="value" />
+                  <OperationsPlot.Point x="label" y="value" />
+                </OperationsPlot.Root>
               </CardContent>
             </Card>
           </Block>

package/dist/templates/spa/src/pages/public/_routes.tsx

@@ -1,6 +1,8 @@
 import { route } from '@askrjs/askr/router';
 import HomePage from './home';
+// askr:imports
 
 export function registerPublicRoutes(): void {
+  // askr:routes
   route('/', HomePage);
 }

package/dist/templates/spa/src/styles.css

@@ -1,5 +1,5 @@
 @import '@askrjs/themes/default';
-@import '@askrjs/charts/default';
+@import '@askrjs/charts/styles';
 @import './styles/reset.css';
 @import './styles/tokens.css';
 @import './styles/theme.css';

package/dist/templates/spa/tsconfig.json

@@ -13,7 +13,8 @@
     "isolatedModules": true,
     "noEmit": true,
     "jsx": "preserve",
-    "jsxImportSource": "@askrjs/askr"
+    "jsxImportSource": "@askrjs/askr",
+    "types": ["@askrjs/themes"]
   },
   "include": ["src", "tests"],
   "references": [{ "path": "./tsconfig.node.json" }]

package/dist/templates/spa/vitest.config.ts

@@ -3,10 +3,6 @@ import { askr } from '@askrjs/vite';
 
 export default defineConfig({
   plugins: [askr()],
-  esbuild: {
-    jsx: 'automatic',
-    jsxImportSource: '@askrjs/askr',
-  },
   test: {
     environment: 'jsdom',
     globals: true,

package/dist/templates/ssg/README.md

@@ -34,6 +34,6 @@ npm run typecheck  # Type check
 
 ## Static generation
 
-Run `npm run build` to compile browser assets and pre-render every route into `dist/`. The `askr ssg` command owns both full and incremental generation, and publishes routes, metadata, the incremental manifest, and browser assets together.
+Run `npm run build` to compile browser assets and pre-render every route into `dist/`. The `askr ssg` command owns both full and incremental generation, and publishes routes, metadata, the incremental manifest, browser assets, `sitemap.xml`, and the managed `robots.txt` sitemap directive together.
 
 `ssg.config.ts` passes the same immutable route registry used in dev mode, so the shell and leaf pages stay in sync.

package/dist/templates/ssg/package.json

@@ -24,7 +24,7 @@
   "devDependencies": {
     "@askrjs/cli": ">=0.0.2 <0.1.0",
     "@askrjs/vite": ">=0.0.6 <0.1.0",
-    "@types/node": "^26.0.0",
+    "@types/node": "^20.19.0",
     "jsdom": "^29.1.1",
     "typescript": "^6.0.3",
     "vite-plus": "^0.2.4"

package/dist/templates/ssg/ssg.config.ts

@@ -4,6 +4,7 @@ import type { DocumentRenderArgs } from '@askrjs/askr/ssg';
 import { pageRegistry } from './src/routes';
 
 export const outputDir = './dist';
+export const siteUrl = 'https://example.com';
 
 let clientTemplate: string | undefined;
 
@@ -24,6 +25,12 @@ function renderDocument({ appHtml }: DocumentRenderArgs) {
 export const staticConfig = {
   registry: pageRegistry,
   outputDir,
+  siteUrl,
+  sitemap: {
+    routes: {
+      '/preview': false,
+    },
+  },
   document: renderDocument,
   assets: [
     {

package/dist/templates/ssg/tests/ssg-config.test.ts

@@ -3,9 +3,11 @@ import { staticConfig } from '../ssg.config';
 
 describe('SSG config', () => {
   it('keeps the sample route tree explicit', () => {
-    expect(staticConfig.registry.manifest.records.map((route) => route.path).sort()).toEqual(
-      ['/', '/content', '/preview', '/workflow'].sort()
-    );
+    expect(
+      staticConfig.registry.manifest.records.map((route) => route.path).sort()
+    ).toEqual(['/', '/content', '/preview', '/workflow'].sort());
     expect(staticConfig.registry.routes).toHaveLength(4);
+    expect(staticConfig.siteUrl).toBe('https://example.com');
+    expect(staticConfig.sitemap.routes['/preview']).toBe(false);
   });
 });

package/dist/templates/ssg/tsconfig.json

@@ -13,7 +13,8 @@
     "isolatedModules": true,
     "noEmit": true,
     "jsx": "react-jsx",
-    "jsxImportSource": "@askrjs/askr"
+    "jsxImportSource": "@askrjs/askr",
+    "types": ["@askrjs/themes"]
   },
   "include": ["src"],
   "references": [{ "path": "./tsconfig.node.json" }]

package/dist/templates/ssg/vitest.config.ts

@@ -3,10 +3,6 @@ import { askr } from '@askrjs/vite';
 
 export default defineConfig({
   plugins: [askr()],
-  esbuild: {
-    jsx: 'automatic',
-    jsxImportSource: '@askrjs/askr',
-  },
   test: {
     environment: 'jsdom',
     globals: true,

package/dist/templates/ssr/package.json

@@ -6,7 +6,7 @@
     "dev": "vp dev",
     "build": "vp build && vp build --ssr server.ts --outDir dist/server",
     "preview": "node dist/server/server.js",
-    "test": "vp test run",
+    "test": "vp test run -c ./vitest.config.ts",
     "typecheck": "tsc --noEmit",
     "lint": "vp lint src server.ts tests vite.config.ts",
     "lint:fix": "npm run lint -- --fix",
@@ -22,7 +22,7 @@
   },
   "devDependencies": {
     "@askrjs/vite": ">=0.0.6 <0.1.0",
-    "@types/node": "^26.0.0",
+    "@types/node": "^20.19.0",
     "jsdom": "^29.1.1",
     "tsx": "^4.23.1",
     "typescript": "^6.0.3",

package/dist/templates/ssr/server.ts

@@ -1,16 +1,10 @@
-import { listen } from '@askrjs/node';
+import { serve } from '@askrjs/node';
 import app from 'virtual:askr-server';
 
 const port = Number(process.env.PORT ?? 3000);
-const server = await listen(app, {
+const running = await serve(app, {
   host: process.env.HOST ?? '127.0.0.1',
   port,
+  assets: { root: new URL('./dist', import.meta.url).pathname },
 });
-const address = server.address();
-const boundPort = typeof address === 'object' && address ? address.port : port;
-
-console.log(`Server started at http://127.0.0.1:${boundPort}`);
-
-const shutdown = () => server.close();
-process.once('SIGINT', shutdown);
-process.once('SIGTERM', shutdown);
+console.log(`Server started at ${running.url}`);

package/dist/templates/ssr/src/entry-server.tsx

@@ -1,9 +1,11 @@
-import { createServerApp } from '@askrjs/server';
-import { createAskrPageHandler } from '@askrjs/server/askr';
+import { createAskrApp } from '@askrjs/server/askr';
 import { pageRegistry } from './routes';
 
-const app = createServerApp({
-  fallback: createAskrPageHandler({ registry: pageRegistry }),
+const app = createAskrApp({
+  name: '{{appName}}',
+  version: '0.1.0',
+  dependencies: undefined,
+  pages: pageRegistry,
 });
 
 export { app };