create-hozu 0.4.1 → 0.5.0

package/dist/index.d.ts

@@ -29,6 +29,7 @@ export declare const packageJson: (name: string, version: string) => {
         '@hozu/data': string;
         '@hozu/runtime-server': string;
         '@hozu/schema-zod': string;
+        '@hozu/transform': string;
         zod: string;
     };
     devDependencies: {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;AAChD,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAE1D,eAAO,MAAM,MAAM,EAAE,SAAS,KAAK,EAAiC,CAAA;AAGpE,eAAO,MAAM,YAAY,QAAsB,CAAA;AAiB/C,eAAO,MAAM,QAAQ,cAAe,MAAM,GAAG,SAAS,KAAG,MAGxD,CAAA;AAWD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBzG;AAYD,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,WAAW,SAAU,MAAM,WAAW,MAAM;;;;;QAKrD,KAAK;QACL,KAAK;QACL,KAAK;;;QAGL,oBAAoB;QACpB,YAAY;QACZ,WAAW;QACX,YAAY;QACZ,sBAAsB;QACtB,kBAAkB;QAClB,GAAG;;;QAGH,WAAW;QACX,eAAe;QACf,aAAa;QACb,UAAU;;;QAED,IAAI;;CACf,CAAA;AAEF,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;AAChD,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAE1D,eAAO,MAAM,MAAM,EAAE,SAAS,KAAK,EAAiC,CAAA;AAGpE,eAAO,MAAM,YAAY,QAAsB,CAAA;AAiB/C,eAAO,MAAM,QAAQ,cAAe,MAAM,GAAG,SAAS,KAAG,MAGxD,CAAA;AAWD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBzG;AAYD,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,WAAW,SAAU,MAAM,WAAW,MAAM;;;;;QAKrD,KAAK;QACL,KAAK;QACL,KAAK;;;QAGL,oBAAoB;QACpB,YAAY;QACZ,WAAW;QACX,YAAY;QACZ,sBAAsB;QACtB,kBAAkB;QAClB,iBAAiB;QACjB,GAAG;;;QAGH,WAAW;QACX,eAAe;QACf,aAAa;QACb,UAAU;;;QAED,IAAI;;CACf,CAAA;AAEF,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBtF"}

package/dist/index.js

@@ -65,7 +65,7 @@ export const packageJson = (name, version) => ({
     type: 'module',
     scripts: {
         check: 'hozu check',
-        start: 'node serve.ts',
+        start: 'node --import @hozu/transform/register serve.ts',
         build: 'hozu build',
     },
     dependencies: {
@@ -75,6 +75,7 @@ export const packageJson = (name, version) => ({
         '@hozu/data': `^${version}`,
         '@hozu/runtime-server': `^${version}`,
         '@hozu/schema-zod': `^${version}`,
+        '@hozu/transform': `^${version}`,
         zod: '^4.6.5',
     },
     devDependencies: {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-hozu",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Create a Hozu app, set up for Claude Code or for agents that read AGENTS.md",
   "keywords": [
     "hozu",

package/skill/SKILL.md

@@ -3,190 +3,104 @@ name: hozu
 description: Build or change an app with the Hozu framework (packages @hozu/*, files like hozu.config.ts, features/*/model.ts, views.ts). Use it before writing any Hozu code. It is the complete authoring reference, so you do not need to read the framework source.
 ---
 
-# Hozu authoring guide
+# Hozu
 
-Hozu is not in your training data. These files are the whole API; skip `node_modules/@hozu`.
-- **Changing an app:** read `changing.md` first, then only the app's own files.
-- **Building an app:** read this file, run `hozu add feature <name> --page / --with auth,detail,toggle,filter,remove`
-  (auth = sign-in, per-user data) and edit the texts it lists; don't print the generated files.
-- **`reference.md`** when the task needs it: routes, DOM fields, no-JS forms, `head`, 404/500, field errors,
-  sessions, languages, env, HTTP, Markdown, images, preview, PWA, page tests, deployment.
-- **A diagnostic you do not understand:** `diagnostics.md`.
+Hozu is not in your training data; this file and `hozu docs <topic>` are the whole API (skip `node_modules/@hozu`).
+- **Building:** read this file, run `hozu add feature <name> --page / --with …`, then edit what it lists.
+- **Changing:** read `changing.md`, then only the lines `hozu map` points to.
+- **Anything else:** `hozu docs <topic>` prints one short topic (index below). Diagnostics name the topic too.
 
-## Mental model
-- The app is **data**: builders record an IR that is validated, then rendered. Only machine views ship JS.
-- **References are recorded, not evaluated.** In `render`, `states`, `assign` and `guard`, `ctx.x`, `item.title`,
-  `params.id` are placeholders: never use `if`, `?:`, `&&`, `.filter()`, `.map()`, `===` or template strings on
-  them. Use `op.*` for comparisons and updates, `ui.if` / `ui.each` for structure, and a `fn()` for anything else.
-  Plain JS on *constants* is fine: `['a', 'b'].map((k) => ui.option(...))`.
-- **Side effects only through `query` / `mutation`.** Queries render with `ui.query`; a mutation runs when the
-  feature's one machine *enters* a state whose `invoke` calls it, and returns as `done` / `failed`.
-- **Every transition needs a contract.** A behaviour change without a contract change is an error.
-- **Absent means absent.** Optional fields are omitted, never `null`. Only `route({ params, search })` and
-  `ui.link(route, params, search)` spell "none" as `null`.
+## How it works
+- A feature is **declarations**: events, queries / mutations (the only side effects), one machine, views,
+  contracts. Builders record them as data (an IR) that is validated, then rendered on the server. Only views bound
+  to the machine ship JS.
+- **Callbacks are ordinary TypeScript** (`render`, `guard`, `assign`, `navigate`, `ui.each` / `ui.query`
+  callbacks): `===`, `!==`, `<`, `&&`, `||`, `!`, `??`, `c ? a : b`, template strings, `+`, `-`, `.length`, and in
+  `assign`, `ctx.x = v`, `ctx.n += 1`, `ctx.list.push(v)`, `ctx.list = ctx.list.filter((i) => i.id !== e.id)`.
+  Methods on data (`.map`, `.toUpperCase()`…) are not: use `ui.each` for lists and a `fn()` for computation.
+- A mutation runs when the machine **enters** a state whose `invoke` calls it; that state drops other events, and
+  `done` / `failed` leave it. Contracts are needed only where a transition decides (a guard, `navigate`, a `fn`).
 
-## Files
+## Files and commands
 ```
-hozu.config.ts  project(): schema adapter, site, routes, pages, features
-routes.ts  route() declarations
-server.ts  resolvers(project, implement => [...]): query/mutation implementations
-serve.ts  createServer({ build, styles, resolvers }).listen(PORT)
-app.css  @import "tailwindcss";
-features/<name>/
-  model.ts  schemas, events, query / mutation / tag / fn, the machine
-  views.ts  views, contracts, feature()
+hozu.config.ts  project({ schema, site, routes, pages, features })      routes.ts  route() declarations
+features/<name>/model.ts  schemas, events, effects, machine             views.ts  views, contracts, feature()
+features/<name>/server.ts  implement(...) resolvers                     serve.ts  createServer(...)
 ```
-
-## Commands (from the app directory)
 ```
-pnpm exec hozu check  # after every edit: types, rules, contracts
-pnpm exec hozu check --update-lock  # accept an intended behaviour change
-pnpm exec hozu add feature items --page / --with detail,toggle  # a working feature, wired in
-pnpm exec hozu map  # outline of the app with file:line
-pnpm exec hozu get / --select button --forms  # pages without a server: text, attributes, forms
-pnpm exec hozu post / --field title=A --next 'POST / title=a' --next /  # submit a form like a browser
+npx hozu check                      # after every edit: types, rules, contracts
+npx hozu check --update-lock        # accept an intended behaviour change
+npx hozu add feature items --page / --with auth,detail,toggle,filter,remove
+npx hozu map                        # outline with file:line
+npx hozu get / --select button --forms          # a page, no server needed
+npx hozu post / --field title=A --next /        # a no-JS form post, cookies shown
+npx hozu docs views                 # one topic
 ```
-Diagnostics give `file:line`, cause and fix: apply the fix. `get` / `post` start from fresh in-memory data;
-chain steps with `--next`. Run `node serve.ts` only to use the app. Relative imports end in `.ts`.
+`get` / `post` replace a running server for checks; `npm start` runs the app. Relative imports end in `.ts`.
 
-## model.ts
+## A feature in one screen
 ```ts
-export const Item = z.object({ id: z.string(), title: z.string(), read: z.boolean() })
+// model.ts
+export const Item = z.object({ id: z.string(), title: z.string(), done: z.boolean() })
 export const Add = event({ payload: z.object({ title: z.string() }) })
-
-export const itemsTag = tag({ param: null })  // or tag({ param: z.string() }) → itemsTag(x)
-export const listItems = query({
-  input: z.object({}), output: z.array(Item),
-  scope: 'public',  // 'user' = per-session data (needs project session)
-  freshness: 'static',  // | { revalidate: s } | { swr: s } | 'live'
-  tags: () => [itemsTag()],  // optional; (input) => [...]
-})
-export const getItem = query({ input: Key, output: Item, errors: { NotFound: Key }, … })
-export const addItem = mutation({
-  input: z.object({ title: z.string().min(2, 'Use at least 2 characters') }), output: Item,
-  errors: { Duplicate: z.object({ title: z.string() }) },  // optional: declared failures
-  invalidates: () => [itemsTag()],  // refreshes queries with these tags
-})
-export const unread = fn({  // pure JS, self-contained: no imports or closures
-  input: z.object({ items: z.array(Item) }), output: z.array(Item),
-  impl: ({ items }) => items.filter((i) => !i.read),
-})
-
-export const m = machine({
+export const itemsTag = tag({ param: null })
+export const listItems = query({ input: z.object({}), output: z.array(Item), scope: 'public',
+  freshness: 'static', tags: () => [itemsTag()] })
+export const addItem = mutation({ input: z.object({ title: z.string().min(2, 'Too short') }), output: Item,
+  errors: { Duplicate: z.object({ title: z.string() }) }, invalidates: () => [itemsTag()] })
+export const items = machine({
   context: z.object({ draft: z.string(), error: z.string().nullable() }),
   initialContext: { draft: '', error: null },
   initial: 'idle',
   states: ({ ctx }) => ({
-    idle: {
-      on: [
-        on(Draft, { target: 'idle', assign: (e) => [op.set(ctx.draft, e.text)] }),
-        on(Add, { target: 'adding', guard: (e) => op.neq(e.title, ''),  // first matching guard wins
-                  assign: (e) => [op.set(ctx.draft, e.title), op.set(ctx.error, null)] }),
-      ],
-    },
+    idle: { on: [on(Add, { target: 'adding', assign: (e) => { ctx.draft = e.title; ctx.error = null } })] },
     adding: {
-      ignore: [Draft, Add],  // events dropped while busy (HZ005)
-      invoke: invoke(addItem, {  // runs on entering the state
+      invoke: invoke(addItem, {
         input: { title: ctx.draft },
-        done: [{ target: 'idle', assign: () => [op.set(ctx.draft, '')],
-                 navigate: (r) => ui.link(itemPage, { id: r.id }) }],  // optional
-        failed: {  // every declared error + Unexpected
-          Duplicate: [{ target: 'idle', assign: () => [op.set(ctx.error, 'Already exists')] }],
-          Unexpected: [{ target: 'idle', assign: (e) => [op.set(ctx.error, e.message)] }],
+        done: { target: 'idle', assign: () => { ctx.draft = '' } },
+        failed: {
+          Duplicate: { target: 'idle', assign: () => { ctx.error = 'Already listed' } },
+          Unexpected: { target: 'idle', assign: (e) => { ctx.error = e.message } },
         },
       }),
     },
-    flash: { after: [{ ms: 3000, target: 'idle' }] },  // timers; `final: true` for terminal states
   }),
 })
-```
-- `op.set`, `op.append(list, item)`, `op.inc(n, by)`, `op.removeWhere(list, 'key', value)`.
-- Guards: `op.eq / neq / lt / lte / gt / gte`, `op.and(...)`, `op.or(...)`, `op.not(g)`, or a boolean `fn`. The
-  reference goes on the left: `op.eq(ctx.tab, 'design')`.
-- A transition to the same state re-enters it and re-runs its `invoke`; busy states `ignore` instead.
-
-## views.ts
-```ts
+// views.ts
 export const Board = ui.view({
-  machine: m,  // optional: without it, no ctx / when / events, 0 JS
-  route: home,  // optional: render gets { params, search } typed by the route
-  render: ({ ctx, when, search }) =>
+  machine: items,
+  render: ({ ctx, when }) =>
     ui.main({ class: 'mx-auto max-w-xl' }, [
       ui.form({ on: { submit: ui.send(Add, { title: ui.dom.form('title') }) } }, [
-        ui.input({ name: 'title', required: true, value: ctx.draft,
-                   on: { input: ui.send(Draft, { text: ui.dom.value }) } }),
+        ui.input({ name: 'title', required: true, value: ctx.draft }),
         ui.button({ type: 'submit' }, ['Add']),
       ]),
-      ui.if(op.neq(ctx.error, null), [ui.p({ role: 'alert' }, [ctx.error])], []),
-      when(['adding'], [ui.p({ 'aria-busy': 'true' }, ['Adding…'])]),
+      ctx.error !== null && ui.p({ role: 'alert' }, [ctx.error]),
+      when(['adding'], [ui.p({ 'aria-busy': 'true' }, [`Adding ${ctx.draft}…`])]),
       ui.query(listItems, {}, {
-        ready: (items) => ui.ul({}, [ui.each(items, 'id', (i) =>
-          ui.li({}, [ui.a({ href: ui.link(itemPage, { id: i.id }) }, [i.title])]))]),
-        pending: ui.p({}, ['Loading…']),  // or null
+        ready: (list) => ui.ul({}, [ui.each(list, 'id', (i) => ui.li({}, [i.title, i.done ? ' ✓' : '']))]),
         failed: { Unexpected: () => ui.p({ role: 'alert' }, ['Unavailable']) },
       }),
     ]),
 })
+export const todos = feature({ id: 'todos', intent: { summary: 'A to-do list' },
+  declarations: { Add, itemsTag, listItems, addItem, items, Board } })
 ```
-- `ui.<tag>(attrs, children)`; values are literals, references or guards. `ui.each(list, 'id', (item) => node)`.
-- `class` is a static string of Tailwind classes that must exist (HZ026). Conditional classes:
-  `toggle: { 'bg-indigo-600 text-white': op.eq(ctx.tab, t) }`. CSS variables: `vars: { '--hue': item.hue }`.
-- Events: `on: { click: ui.send(Event, payload) }`. Payload fields: literals, references, `ui.dom.value`,
-  `ui.dom.form('name')`, `ui.dom.checked`, `ui.dom.valueAsNumber`, `ui.dom.key`.
-- Links: `ui.link(route, params, search)`, never a string path (HZ032). The third argument exists only when the
-  route declares `search` (`null` = all defaults). Filters that belong in the URL are `search` links, not context.
-- A form whose submit reads only `ui.dom.form(...)`, literals, context, params and search also works without JS.
-
-### Contracts
-```ts
-export const adds = contract(m, {
-  given: { state: 'idle' },  // context: optional, defaults to initialContext
-  when: [
-    { send: Add, payload: { title: 'A' } },
-    { done: addItem, result: { id: 'i9', title: 'A', read: false } },
-  ],  // or { failed: addItem, error: 'Duplicate', data } / { elapse: ms }
-  expect: {
-    state: 'idle',
-    changes: { error: null },  // only what changes; every other field must stay equal
-    effects: [{ effect: addItem, input: { title: 'A' } }, { navigate: '/items/i9' }],  // optional: none
-  },
-})
-```
-Cover each `on`, `done`, `failed` and `after` once. `given.context` sets up a full context; nested objects in
-`changes` are patches too, arrays are replaced. HZ016 prints each missing contract ready to paste.
-
-### Feature
-```ts
-export const items = feature({
-  id: 'items',
-  intent: { summary: 'A reading list', invariants: ['Titles are unique'] },  // invariants optional
-  declarations: { Add, Draft, itemsTag, listItems, getItem, addItem, unread, m, Board, Detail, adds },
-})
-```
-Every declaration goes in `declarations` once, under its name. Optional: `imports: [otherFeature]`,
-`exports: [Event, query, …]` (all other features may use), `styles: [new URL('./x.css', import.meta.url)]`.
-
-## hozu.config.ts
-`project({ schema: zodAdapter, styles, site: { url, name, lang }, routes: { home, itemPage }, pages, features })`;
-`hozu add feature --page` adds static pages. A page with params:
-```ts
-    ui.page(itemPage, {
-      views: [Detail],
-      head: {
-        query: getItem,  // its failure sets the status (NotFound → 404)
-        input: (params) => ({ id: params.id }),
-        render: (item) => ({ title: item.title, description: item.title, type: 'article' }),
-      },
-      entries: { query: listItems, input: {}, params: (item) => ({ id: item.id }) },  // sitemap
-    }),
-```
-```ts
-// routes.ts
-export const home = route({ path: '/', params: null, search: z.object({ show: Show.default('all') }) })
-export const itemPage = route({ path: '/items/:id', params: z.object({ id: z.string() }), search: null })
-```
+Every declaration goes in `declarations` once, under its name. Resolvers:
+`implement(addItem, ({ title }, { fail }) => exists ? fail('Duplicate', { title }) : save(title))`.
 
-## server.ts
-`export const createResolvers = () => resolvers(project, (implement) => [...])`, one
-`implement(getItem, ({ id }, { fail }) => item ?? fail('NotFound', { id }))` per query / mutation. `hozu add feature` puts a feature's resolvers in `features/<name>/server.ts`.
-Input failing its schema returns `Invalid` (`{ message, fields }`; `reference.md`).
+## Topics (`hozu docs <topic>`)
+| Task | Topic |
+|---|---|
+| elements, attributes, classes, events, DOM fields, lists, links | `views` |
+| states, events, invoke, timers, guards, updates | `machine` |
+| queries, mutations, tags, errors, `fn()`, resolvers | `data` |
+| writing and checking contracts | `contracts` |
+| routes, params, search, pages, `head`, 404, sitemap | `pages` |
+| forms without JS, field errors, selects | `forms` |
+| sign-in, sessions, per-user data | `auth` |
+| common UI: filters, empty states, per-item actions, load more, optimistic | `patterns` |
+| webhooks and JSON APIs | `endpoints` |
+| browser APIs and DOM libraries (maps, charts) | `widgets` |
+| languages, env, HTTP, Markdown, images, preview, PWA, tests, deployment | `i18n`, `env`, `http`, `content`, `testing`, `deploy` |
+| a diagnostic code | `diagnostics` |

package/skill/changing.md

@@ -7,7 +7,7 @@ Keep the loop short: map once, edit everything, check once, verify once.
 - `pnpm exec hozu map`: every route, query, mutation, event, state, view and contract, each with its `file:line`.
   Open only the lines the change touches. Below, *model* is where the app keeps schemas, events, effects and
   the machine (`model.ts`), and *views* where it keeps views, contracts and `feature()`.
-- The API is in `SKILL.md`. Use a recipe below when one fits; open `patterns.md` / `reference.md` only for
+- The API is in `SKILL.md`. Use a recipe below when one fits; run `hozu docs <topic>` only for
   something else.
 
 ## 2. Recipes
@@ -20,33 +20,28 @@ Names follow `hozu add feature items`: `Item`, `NewItem`, `Add`, `addItem`, `ite
   - context: `priority: Priority`, with `priority: 'normal'` in `initialContext`;
   - `fields` gets `priority: z.string().nullable()`, with `priority: null` in `initialContext` and in the `Add`
     assign that resets it;
-  - the `Add` assign also gets `op.set(ctx.priority, e.priority)`, and the add `invoke` input becomes
+  - the `Add` assign also gets `ctx.priority = e.priority`, and the add `invoke` input becomes
     `{ title: ctx.draft, priority: ctx.priority }`.
 - **views:**
   - the form's submit sends `{ title: ui.dom.form('title'), priority: ui.dom.form('priority') }`;
   - inside the form add
     `ui.select({ name: 'priority', 'aria-label': 'Priority', class: 'rounded border px-2' }, ['low', 'normal', 'high'].map((p) => ui.option({ value: p, selected: p === 'normal' }, [p])))`;
   - in the item: `ui.span({ class: 'text-xs' }, [item.priority])`.
-- **Contracts:**
-  - add `priority: 'normal'` to every `Add` payload, to the add effect's input, and to the `done` result;
-  - `rejectsInvalid`'s `data.fields` and `changes.fields` get `priority: null`.
+- **Contracts:** if the app has contracts that send `Add` or return an item, add `priority` to their payloads,
+  inputs and results. These transitions only copy values, so they need no new contract.
 - **server:** store `priority` (seed items included) and return it.
 
 ### An action button that works on many items (e.g. "Clear done")
 - **model:**
   - `export const ClearDone = event({ payload: z.object({}) })`;
   - `export const clearDone = mutation({ input: z.object({}), output: z.object({ removed: z.number() }), invalidates: () => [itemsTag()] })`;
-  - in `idle`: `on(ClearDone, { target: 'clearing', assign: () => [op.set(ctx.error, null)] })`;
+  - in `idle`: `on(ClearDone, { target: 'clearing', assign: () => { ctx.error = null } })`;
   - a state
-    `clearing: { ignore: [...], invoke: invoke(clearDone, { input: {}, done: [{ target: 'idle' }], failed: { Unexpected: [{ target: 'idle', assign: (e) => [op.set(ctx.error, e.message)] }] } }) }`;
-  - add `ClearDone` to every busy state's `ignore`, and give `clearing` the same list.
+    `clearing: { invoke: invoke(clearDone, { input: {}, done: 'idle', failed: { Unexpected: { target: 'idle', assign: (e) => { ctx.error = e.message } } } }) }`
+    (busy states drop events they do not handle, so no `ignore`).
 - **views:** the control
   `ui.form({ on: { submit: ui.send(ClearDone, {}) } }, [ui.button({ type: 'submit', class: 'text-sm underline' }, ['Clear done'])])`.
-- **Contracts:**
-  - `given: { state: 'idle' }`, when `[{ send: ClearDone, payload: {} }, { done: clearDone, result: { removed: 1 } }]`,
-    expect `{ state: 'idle', effects: [{ effect: clearDone, input: {} }] }`;
-  - a second one for `failed … 'Unexpected'` from `clearing`;
-  - add `ClearDone`, `clearDone` and both contracts to `declarations`.
+- Add `ClearDone` and `clearDone` to `declarations`. The new transitions only copy values, so they need no contract.
 - **server:**
   `implement(clearDone, () => { const before = items.length; items.splice(0, items.length, ...items.filter((i) => !i.done)); return { removed: before - items.length } })`.
 - **Try it:** `hozu post / --button 'Clear done' --next /`.
@@ -66,20 +61,22 @@ Run a fresh scaffold into a scratch app with `--with detail`, and copy the parts
 ### Other changes
 | Change | Touch |
 |---|---|
-| New UI-only state (a tab) | model: the context field and its initial value, an event, an `on` that `op.set`s it (add the event to every busy state's `ignore`) → views: the control, a contract, the event in `declarations`. |
+| New UI-only state (a tab) | model: the context field and its initial value, an event, an `on` whose `assign` sets it → views: the control, the event in `declarations` (no contract: it only copies a value). |
 | Filter / sort / page in the URL | the route's `search` schema (with a default) → links with `ui.link(route, params, { key: value })` → read `search.key` in the view. No machine change. |
 | New page | `routes.ts` → a view with `route`, in `declarations` → `ui.page(...)` in `hozu.config.ts` (`head`, and `entries` when the route has params). |
 
 Whenever the machine changes:
-- Add one contract per new transition; HZ016 prints each missing one ready to paste.
-- Every busy state `ignore`s every event its visible controls can send; HZ005 prints the missing entries.
+- A transition that decides something (a guard, `navigate`, or a `fn` in its values) needs a contract; HZ016
+  prints each missing one ready to paste. Transitions that only copy values are reviewed through the lock.
+- States with `invoke` drop unhandled events by themselves. Other states must handle or `ignore` every event their
+  visible controls send; HZ005 prints the missing entries.
 
 ## 3. Check (once, after all edits)
 ```
 pnpm exec hozu check
 ```
-Fix what it reports. When the behaviour change is intended and everything is clean, run
-`pnpm exec hozu check --update-lock`. HZ018 asks for this.
+Fix what it reports. When the behaviour change is intended, run `pnpm exec hozu check --update-lock`: HZ018 shows
+each changed transition as `was: … now: …`, and accepting it updates the lock.
 
 ## 4. Verify (once, no server needed)
 - **Pages:** `pnpm exec hozu get / /items/i1` prints the status, title, alerts and visible text.

package/skill/example/features/bookmarks/model.ts

@@ -1,4 +1,4 @@
-import { event, fn, invoke, machine, mutation, on, op, query, tag, ui } from '@hozu/core'
+import { event, fn, invoke, machine, mutation, on, query, tag, ui } from '@hozu/core'
 import { z } from 'zod'
 import { bookmarkPage, Show } from '../../routes.ts'
 
@@ -83,45 +83,73 @@ export const bookmarksMachine = machine({
   states: ({ ctx }) => ({
     idle: {
       on: [
-        on(Draft, { target: 'idle', assign: (e) => [op.set(ctx.draft, e.text)] }),
+        on(Draft, {
+          target: 'idle',
+          assign: (e) => {
+            ctx.draft = e.text
+          },
+        }),
         on(Add, {
           target: 'adding',
-          assign: (e) => [
-            op.set(ctx.draft, e.title),
-            op.set(ctx.kind, e.kind),
-            op.set(ctx.error, null),
-            op.set(ctx.fields, { title: null, kind: null }),
-          ],
+          assign: (e) => {
+            ctx.draft = e.title
+            ctx.kind = e.kind
+            ctx.error = null
+            ctx.fields = { title: null, kind: null }
+          },
+        }),
+        on(ToggleRead, {
+          target: 'toggling',
+          assign: (e) => {
+            ctx.target = e.id
+          },
         }),
-        on(ToggleRead, { target: 'toggling', assign: (e) => [op.set(ctx.target, e.id)] }),
       ],
     },
     adding: {
-      ignore: [Draft, Add, ToggleRead],
       invoke: invoke(addBookmark, {
         input: { title: ctx.draft, kind: ctx.kind },
-        done: [
-          {
-            target: 'idle',
-            assign: () => [op.set(ctx.draft, '')],
-            navigate: (b) => ui.link(bookmarkPage, { id: b.id }),
+        done: {
+          target: 'idle',
+          assign: () => {
+            ctx.draft = ''
           },
-        ],
+          navigate: (b) => ui.link(bookmarkPage, { id: b.id }),
+        },
         failed: {
-          Duplicate: [{ target: 'idle', assign: () => [op.set(ctx.error, DUPLICATE)] }],
-          Invalid: [{ target: 'idle', assign: (e) => [op.set(ctx.fields, e.fields)] }],
-          Unexpected: [{ target: 'idle', assign: (e) => [op.set(ctx.error, e.message)] }],
+          Duplicate: {
+            target: 'idle',
+            assign: () => {
+              ctx.error = DUPLICATE
+            },
+          },
+          Invalid: {
+            target: 'idle',
+            assign: (e) => {
+              ctx.fields = e.fields
+            },
+          },
+          Unexpected: {
+            target: 'idle',
+            assign: (e) => {
+              ctx.error = e.message
+            },
+          },
         },
       }),
     },
     toggling: {
-      ignore: [Draft, Add, ToggleRead],
       invoke: invoke(toggleRead, {
         input: { id: ctx.target },
-        done: [{ target: 'idle' }],
+        done: 'idle',
         failed: {
-          NotFound: [{ target: 'idle' }],
-          Unexpected: [{ target: 'idle', assign: (e) => [op.set(ctx.error, e.message)] }],
+          NotFound: 'idle',
+          Unexpected: {
+            target: 'idle',
+            assign: (e) => {
+              ctx.error = e.message
+            },
+          },
         },
       }),
     },

package/skill/example/features/bookmarks/views.ts

@@ -1,4 +1,4 @@
-import { contract, feature, op, ui } from '@hozu/core'
+import { contract, feature, ui } from '@hozu/core'
 import { bookmarkPage, home } from '../../routes.ts'
 import {
   Add,
@@ -41,20 +41,20 @@ export const Board = ui.view({
             minlength: 2,
             maxlength: 80,
             value: ctx.draft,
-            'aria-invalid': op.neq(ctx.fields.title, null),
+            'aria-invalid': ctx.fields.title !== null,
             'aria-describedby': 'title-error',
             class: 'flex-1 rounded border px-3 py-2',
             on: { input: ui.send(Draft, { text: ui.dom.value }) },
           }),
           ui.select(
             { name: 'kind', 'aria-label': 'Kind', class: 'rounded border px-2' },
-            kinds.map((k) => ui.option({ value: k, selected: op.eq(ctx.kind, k) }, [k])),
+            kinds.map((k) => ui.option({ value: k, selected: ctx.kind === k }, [k])),
           ),
           ui.button({ type: 'submit', class: 'rounded bg-indigo-600 px-4 py-2 text-white' }, ['Add']),
         ],
       ),
       ui.p({ id: 'title-error', class: 'text-sm text-rose-600' }, [ctx.fields.title]),
-      ui.if(op.neq(ctx.error, null), [ui.p({ role: 'alert', class: 'text-rose-600' }, [ctx.error])], []),
+      ctx.error !== null && ui.p({ role: 'alert', class: 'text-rose-600' }, [ctx.error]),
       when(
         ['adding'],
         [
@@ -71,7 +71,7 @@ export const Board = ui.view({
           ui.a(
             {
               href: ui.link(home, null, { show: s.value }),
-              'aria-current': op.eq(search.show, s.value),
+              'aria-current': search.show === s.value,
               class:
                 'rounded-full border px-3 py-1 aria-[current=true]:bg-indigo-600 aria-[current=true]:text-white',
             },
@@ -84,11 +84,9 @@ export const Board = ui.view({
         {},
         {
           ready: (items) =>
-            ui.if(
-              isEmpty({ items, show: search.show }),
-              [ui.p({ class: 'text-slate-500' }, ['No bookmarks'])],
-              [
-                ui.ul({ class: 'divide-y rounded border' }, [
+            isEmpty({ items, show: search.show })
+              ? ui.p({ class: 'text-slate-500' }, ['No bookmarks'])
+              : ui.ul({ class: 'divide-y rounded border' }, [
                   ui.each(visible({ items, show: search.show }), 'id', (b) =>
                     ui.li({ class: 'flex items-center gap-3 px-4 py-3' }, [
                       ui.a({ href: ui.link(bookmarkPage, { id: b.id }), class: 'flex-1 underline' }, [
@@ -101,13 +99,11 @@ export const Board = ui.view({
                           class: 'text-sm',
                           on: { click: ui.send(ToggleRead, { id: b.id }) },
                         },
-                        [ui.if(op.eq(b.read, true), ['Mark unread'], ['Mark read'])],
+                        [b.read ? 'Mark unread' : 'Mark read'],
                       ),
                     ]),
                   ),
                 ]),
-              ],
-            ),
           pending: ui.p({}, ['Loading…']),
           failed: { Unexpected: () => ui.p({ role: 'alert' }, ['Bookmarks are unavailable']) },
         },
@@ -127,7 +123,7 @@ export const Detail = ui.view({
             ui.article({}, [
               ui.h1({ class: 'text-3xl font-bold' }, [b.title]),
               ui.p({}, ['Kind: ', b.kind]),
-              ui.p({}, [ui.if(op.eq(b.read, true), ['Read'], ['Unread'])]),
+              ui.p({}, [b.read ? 'Read' : 'Unread']),
             ]),
           pending: null,
           failed: {

package/skill/topics/auth.md

@@ -0,0 +1,12 @@
+# Sign-in, sessions, per-user data
+
+- **Start from the scaffold:** `hozu add feature notes --page / --with auth` writes `features/account` (sign-in page,
+  sign-out, `me`), the session cookie in `serve.ts`, per-user resolvers, and a redirect to `/login` when signed out.
+  Replace the name-only sign-in with real credentials before production; set `SESSION_SECRET` (and
+  `SESSION_SECURE=true` behind HTTPS).
+- `project({ session: z.object({ user: z.string() }) })` declares the identity. Queries with `scope: 'user'` and all
+  mutations receive `session`; public queries never do. A mutation calls `setSession(value)` (or `null` to sign out).
+- `createServer({ session: sessionCookie({ name: 'sid', secret }) })` (from `@hozu/runtime-server`): a signed,
+  HttpOnly cookie. The session never reaches browser JavaScript.
+- Guard pages: `head: { query: me, redirects: { Unauthorized: login }, … }`.
+- Calling another API with a token: keep the token in the session (server side) and read it in the resolver.

package/skill/topics/content.md

@@ -0,0 +1,14 @@
+# Markdown, images, share images, fonts, preview, offline
+
+- **Markdown:** `@hozu/content`: `const posts = await loadCollection({ dir: new URL('./content/posts/', import.meta.url), schema })`
+  in `server.ts` gives `{ slug, data, html, headings }`; return it from query resolvers and render `ui.html(post.html)`.
+- **Images:** `ui.img({ src: ui.asset(new URL('./hero.jpg', import.meta.url)), alt, width, height })` (HZ028 without
+  dimensions). With `@hozu/image`, `hozu build` adds WebP `srcset` widths.
+- **Share images:** `head.render → image: ui.og({ title, subtitle })` (needs `og: ogImage` from `@hozu/image` in
+  `createServer`); on a static host use `image: ui.asset(new URL('./share.png', import.meta.url))`.
+- **Fonts:** a local `@font-face` gets a size-matched fallback automatically.
+- **Page transitions:** links cross-fade (CSS view transitions, no JS); turn off with
+  `@view-transition { navigation: none; }` in `app.css`.
+- **Preview:** `createServer({ preview: { secret } })`; `/_hozu/preview?secret=…&path=/posts/a` turns it on; resolvers
+  read `ctx.preview`; preview responses are never cached.
+- **Offline:** `site.offline: route` (a static page) makes a service worker (HZ043).