@happyvertical/smrt-cli 0.55.10 → 0.55.11

package/AGENTS.md

@@ -40,6 +40,10 @@ smrt generate-types          # Generate TypeScript declarations (alias: generate
 smrt generate-routes         # Generate SvelteKit API routes (aliases: routes, generate:routes)
 smrt config:export           # Export agent config for SSG
 smrt init                    # Init new project
+smrt cookbook validate|apply # Cookbook check / project create: agents/cookbook-apply.md
+smrt kitchen [dir]           # Planner on localhost -> cookbook -> apply: agents/kitchen.md
+smrt kitchen apply <url|file> [dir] # cookbook apply, plan URLs too
+smrt kitchen mcp             # stdio MCP server for the local Kitchen plugin: agents/kitchen.md
 smrt gnode                   # Scaffold gnode site
 smrt dispatch:*              # Dispatch management (list/process/retry/cleanup)
 smrt app <op>                # App install/setup/start/migrate/worker…: agents/app-commands.md
@@ -120,25 +124,13 @@ included using the generator's own exhaustive-include rule.
 `renderAgentSurfaceReport(report)` returns the printed lines; both are exported
 so the shape is testable without running the command.
 
-**Known live over-exposure for an STI class with a bare `true`/omitted
-`mcp`/`cli` config, tracked as #2624:** the *scanner's* STI method merge in
-`manifest-generator.ts` walks the full inheritance chain unconditionally, so
-an STI class's `object.methods` already (incorrectly) contains its framework
-base classes' own internal methods (`save`, `toJSON`, `withTransaction`,
-`generateEmbeddings`, `destroy`, ...). This is not only a manifest
-artifact concern: `ObjectRegistry.getAllMethods()`'s runtime chain walk
-(`registry/inheritance-resolver.ts`) never actually filters it back out —
-its `SmrtObject`/`SmrtClass`/`SmrtCollection` ancestor-skip only fires for a
-chain entry literally named one of those three, and `getInheritanceChain()`
-already stops *before* adding such an ancestor to the chain, so that name
-never appears there to be skipped. The STI class itself is always the last
-chain entry, contributing its own (already-polluted) `methods` map
-unfiltered. So `CLIGenerator`/`MCPGenerator` genuinely register
-`<object>:save`, `<object>:withTransaction`, etc. as real, callable
-commands/tools **today, in a running application** — `configuredSurfaces()`
-here is reporting a real exposed surface, not fabricating one. #2624 tracks
-narrowing the scanner's STI method merge (or making the runtime skip
-actually reachable).
+**Known live over-exposure (#2624):** the scanner's STI method merge walks the full
+inheritance chain, so an STI class's `object.methods` contains its framework base
+classes' internal methods (`save`, `toJSON`, `withTransaction`, `destroy`, ...), and
+`ObjectRegistry.getAllMethods()` never filters them back out (its ancestor skip
+cannot fire: `getInheritanceChain()` stops before adding those ancestors). So
+`CLIGenerator`/`MCPGenerator` really register `<object>:save` etc. in a running
+app; `configuredSurfaces()` reports a real surface. #2624 tracks the fix.
 
 Sample output:
 

package/README.md

@@ -198,6 +198,10 @@ knowledge index; documentation snapshots use lightweight package discovery.
 | `smrt config:export` | Export agent config for SSG |
 | `smrt export` | Export data in various formats |
 | `smrt init` | Initialize s-m-r-t in an existing SvelteKit project |
+| `smrt cookbook validate <file\|url>` | Check a cookbook against cookbook/v1 and the recipe manifests |
+| `smrt cookbook apply <file\|url> [dir]` | Create a project from a cookbook and the smrt-start template (`--into`, `--template`, `--dry-run`, `--no-install`) |
+| `smrt kitchen [dir]` | Serve the planner on localhost, chat to a cookbook, **Send to kitchen** applies it into `dir` (`--planner`, `--template`, `--no-open`, `--no-install`) |
+| `smrt kitchen apply <url\|file> [dir]` | `cookbook apply` that also takes a plan URL |
 
 `smrt export` reads the `export` section of `smrt.config.js`. A listed type that
 is not registered fails the command (non-zero exit, naming the type) instead of

package/agents/cookbook-apply.md

@@ -0,0 +1,65 @@
+# `smrt cookbook validate|apply` (#3748)
+
+Code: `src/commands/cookbook.ts` (registration), `src/commands/cookbook/`
+(`recipe-index.ts`, `validate.ts`, `apply.ts`). Contract of the document:
+[`core/agents/cookbook.md`](../../core/agents/cookbook.md).
+
+## Recipe index
+
+Recipes and the objects policies point at come from each package's published
+manifest (`recipes[]`, `objects`), found through its `package.json`
+`exports['./manifest']` (`dist/lib/manifest.json` for SvelteKit-library packages such as
+products), falling back to `dist/manifest.json`, `dist/lib/manifest.json`, `manifest.json`. Read in order:
+
+1. `--manifests <file|dir>` (repeatable): a manifest, a dir of manifests, or a dir of package dirs.
+2. The SMRT workspace around the target (`packages/*`).
+3. `node_modules/@happyvertical/smrt-*` walking up from the target.
+4. The package's registry, resolved as npm does (`@scope:registry` from the `.npmrc` chain or `npm config`,
+   then `npm_config_registry`, then npmjs; an `_authToken` for that host is sent). `@happyvertical` resolves to
+   npm.happyvertical.com, since npmjs lags. Only for
+   packages still unresolved: `@happyvertical/smrt-<recipe-id prefix>` and the
+   packages named by `features`/`policies`. The tarball is fetched and only
+   the manifest is extracted; nothing is installed. `--no-registry` skips it.
+   A cookbook cannot choose what is fetched: only names matching
+   `@happyvertical/smrt-<name>` are looked up (a package of another scope must
+   already be installed locally), the fetched manifest must name the package that
+   was asked for, the registry version must be a plain semver, the token is sent
+   only to the registry's own origin (a foreign tarball host gets none; foreign
+   plain-http is refused), `dist.integrity` is verified when given, and a tarball
+   is capped at 300 MB (a cookbook URL at 2 MB).
+
+`validate` fails (exit 1, `--json` for machines) on: structural errors (core's
+`validateCookbook`), unknown recipe ids, a `requires` id missing from the
+cookbook, a `requiresAny` group with none present, a `features`/`policies`
+object that is not in its package's manifest, or a policy field the object lacks.
+
+## `apply <file|url> [dir]`
+
+- **New project** (default): `[dir]` (or the slug of `cookbook.name`) must be absent or empty. The template is
+  copied (`--template <path|github:owner/repo[#ref]|git URL>`, default
+  `github:happyvertical/smrt-start`, unpinned; a remote template is shallow-fetched, `.git` dropped,
+  and its commit printed). A local template that is a git checkout contributes only tracked plus
+  untracked-but-unignored files (`git ls-files -co --exclude-standard`), so git-ignored generated output
+  (e.g. a stale `src/routes/api/notes`) never reaches the project; uncommitted edits still apply, which
+  `git archive HEAD` would drop. A non-git directory is copied whole minus `.git`/`node_modules`.
+  `package.json` `name` becomes the slug of `cookbook.name` when set, else of the target directory's
+  basename (never the template's name: the runtime derives the app identity, hence the OS data
+  directory, from it).
+- **Existing project**: `--into [dir]`, or re-running on a directory that already holds `smrt.cookbook.json`.
+- **Writes**: missing packages (from the recipes, features and policies) into `dependencies`,
+  sorted; `smrt.cookbook.json` (the validated, normalized cookbook). Nothing else. No sample data.
+- **Versions**: the cookbook carries none (epic #3747). A new dependency takes the range the project already
+  uses for `@happyvertical/smrt-core` (smrt packages release as one group), else `^<this CLI's version>`.
+  Already-declared packages are never changed. Removing a recipe does not remove its package.
+- **Idempotent**: re-applying leaves an identical project untouched; an edited cookbook updates the
+  config file and adds packages without rewriting anything else.
+- `--dry-run` prints the plan (no writes; a remote template is still fetched to a temp dir).
+  `--no-install` skips `<pm> install` (pnpm, or npm/yarn by lockfile). `--json` prints the plan.
+- Next steps printed: install if skipped, then the project's `app:setup` and `app:doctor` scripts
+  (else `npx smrt app setup` / `npx smrt doctor`).
+
+## Intake contract (smrt-start#4, app shell #3749)
+
+`smrt.cookbook.json` at the project root is the cookbook, verbatim v1. An app reads it at
+startup/setup to select recipes, apply policies and layout/theme. The CLI only places
+dependencies and the file; the project is responsible for acting on it.

package/agents/kitchen.md

@@ -0,0 +1,111 @@
+# `smrt kitchen` (#3750)
+
+Code: `src/commands/kitchen.ts` (registration, Ctrl-C), `src/commands/kitchen/`
+(`run.ts` orchestration, `planner.ts` locating the planner, `server.ts` HTTP,
+`ai.ts` the model, `apply.ts` the cookbook hand-off). Planner side:
+`happyvertical/smrt-planner` `docs/inference-host.md` ("Send to kitchen").
+
+```
+smrt kitchen [dir] [--planner <dir>] [--template <t>] [--no-open] [--no-install]
+             [--manifests <p>]... [--no-registry] [--port <n>]
+smrt kitchen apply <url|file> [dir]     # = cookbook apply (any URL that returns cookbook JSON)
+```
+
+`dir` must be absent, empty, or already hold `smrt.cookbook.json` (then it is updated).
+Checked before anything starts.
+
+## Flow
+
+1. Find the planner (below), import its plain-Node `./core`.
+2. Resolve the model; start the server on `127.0.0.1` (random port, or `--port`) with a random
+   one-time token; open the browser (`--no-open` to skip).
+3. The page chats through `/api/planner/chat`, the user builds a cookbook and chooses
+   **Send to kitchen**, which POSTs it to `/api/kitchen/cookbook`.
+4. The server validates (`validateCookbook` + recipe index, as `cookbook validate`), runs the
+   `cookbook apply` engine into `dir` (install progress goes to the terminal), answers the page
+   with the result, then the CLI prints the next steps and exits. A refused cookbook (422) or an
+   unusable directory (409) leaves the server running so the user can fix and send again.
+
+## Server
+
+| Path | |
+| --- | --- |
+| `GET /planner.config.json` | `{ inference, kitchen: { endpoint: "/api/kitchen/cookbook", token } }`; `inference` is `{ mode: "host", host: { endpoint: "/api/planner/chat" } }`, or `{ mode: "browser" }` with no model |
+| `POST /api/planner/chat` | host contract v1: `parseHostRequest` -> `buildHostPrompt` -> model -> `parseHostReply` -> reply JSON. 400 bad request, 502 model failure (message not forwarded), 503 no model |
+| `POST /api/kitchen/cookbook` | header `x-kitchen-token`, same-origin JSON; 200 `{ ok, dir, mode, installed, added, nextSteps }`, 4xx `{ ok: false, errors }` |
+| everything else (GET/HEAD) | the planner's `app/` directory; `/` serves `index.html`; no path leaves `app/` |
+
+Guards: every request's `Host` must be this server (DNS rebinding); the cookbook POST needs a
+matching `Origin` header (chat: matching if present), `content-type: application/json`, a
+timing-safe token match, and is refused after a success. Bodies are capped (chat 256 KB,
+cookbook 2 MB). No CORS headers are sent. Only one cookbook POST applies at a time
+(the slot is claimed before the body is read). The token is served from
+`/planner.config.json`, which any local process that sends this server's `Host` can read:
+the kitchen defends against browsers, not against other users on the same machine, so run
+it on a machine you trust. Keeping the token out of that endpoint needs a planner contract
+change (token in the opened URL's fragment).
+
+## Model
+
+`ai.ts` loads `smrt.config.*` (from `dir` if it exists, else the cwd) and resolves the provider
+with smrt-config's `tryResolveConfiguredAIProvider` (config `ai` block, `SMRT_AI_*`, then a
+provider key variable such as `OPENAI_API_KEY`), then builds it with `getAI` from
+`@happyvertical/ai`. Calls are `chat([system, ...messages], { temperature: 0 })`. With no provider
+the config is served in `browser` mode and the terminal says so.
+
+## Finding the planner
+
+`@happyvertical/smrt-planner` carries a ~70 MB static app, so it is not a dependency. In order:
+
+1. `--planner <dir>`: a packaged checkout (`pnpm package` in the planner repo).
+2. `<cache>/<version>/package/`, where `<cache>` is `$SMRT_CACHE_DIR/planner`, else
+   `$XDG_CACHE_HOME/smrt/planner`, `~/Library/Caches/smrt/planner` (macOS),
+   `%LOCALAPPDATA%\smrt\planner` (Windows) or `~/.cache/smrt/planner`.
+3. The registry that owns the `@happyvertical` scope (`cookbook/registry.ts`, the same scope and
+   token resolution as the recipe index): the latest version is downloaded and extracted into the
+   cache. If the registry cannot be reached, the newest cached version is used.
+
+Otherwise it stops with an error naming `--planner`.
+
+## Tests
+
+`src/commands/__tests__/kitchen.test.ts` uses a generated fake planner package and a stub model.
+Set `SMRT_PLANNER_DIR=<packaged planner checkout>` to also run the suite against the real `./core`.
+
+## `smrt kitchen mcp` (#3752)
+
+```
+smrt kitchen mcp [--template <t>] [--manifests <p>]... [--no-registry] [--packages <name>]... [--library <dir>]...
+```
+
+A stdio MCP server (`@modelcontextprotocol/server`, `serveStdio`) for the local
+agent plugin in [`plugins/smrt-kitchen`](../../../plugins/smrt-kitchen/README.md).
+The host's model reasons; the server holds plans and calls `createCookbookEngine`
+(`smrt-core/cookbook/engine`). It never calls a model and takes no credential.
+**stdout is the protocol stream**: every notice goes to stderr (this is why the
+`.smrt/register.js` warning in `cli-generator.ts` uses `console.warn`).
+
+Code: `src/commands/kitchen/mcp/` (`tools.ts` definitions + `KitchenSession`, `catalog.ts`,
+`server.ts`). Tests: `__tests__/kitchen-mcp.test.ts` (spawns the CLI over stdio with the SDK
+client), `__tests__/kitchen-plugin.test.ts` (plugin files against the Agent Plugins schemas).
+
+| Tool | Hints | |
+| --- | --- | --- |
+| `list_cookbooks`, `search_recipes` | read-only | library (`cookbooks/*.cookbook.json`, kept equal to core's fixtures by a test; `--library` adds dirs) and catalog recipes |
+| `start_plan` | not read-only, not destructive | empty, or from a library cookbook; returns `planId` |
+| `run_commands` | idempotent | one atomic `engine.batch` (`id`, `expectedRevision` pass through); a lone `undo` runs as a command |
+| `get_plan`, `validate_plan`, `export_plan` | read-only | `validate_plan` = engine `validate` + `validateCookbookText` against the catalog's manifests |
+| `apply_plan` | destructive, idempotent, open-world | `createCookbookApplier` (= `cookbook apply`); absolute `dir`; **writes only with `confirm: true` + the preview's `confirmCode`** (sha256 of dir, server template and exported plan, so a changed plan or dir needs a new preview), otherwise (or with `dryRun`) a preview + `confirmation_required`; template is the server's `--template` only; `install` defaults to false and its output goes to stderr; templates containing symlinks are refused |
+
+- **Plans** live in the server process, keyed by `plan-<8 hex>` (20 kept, oldest dropped); a restart
+  forgets them. `smrt.cookbook.json` in the project (written by apply) is the durable copy.
+- **Catalog** is built lazily on first use, once: manifests are resolved for the library's recipes
+  exactly like `cookbook validate` (`--manifests`, workspace, `node_modules`, registry unless
+  `--no-registry`; `--packages` adds more) and turned into `EngineCatalog` (`catalog.ts`: recipes from
+  `manifest.recipes`, models from `manifest.objects`, `exposed` from `decoratorConfig.api`). A package
+  that cannot be found shows up in `warnings` and as `snapshot.unavailable`. Tool schemas are static
+  (no recipe-id enums) so `tools/list` never waits on the network; `search_recipes` is the id source.
+- **Output**: every tool returns compact text for the model plus `structuredContent` that matches its
+  `outputSchema` (`ok` always; `error {code,message,path?,details?}` when false, with `isError`).
+- Not here: the MCP Apps planner widget (see the plugin README), remote/HTTP transport.
+

package/agents/process-fixture-isolation.md

@@ -0,0 +1,29 @@
+# Process fixture isolation (#3762)
+
+The CLI process fixture must have no ancestor `node_modules` directory. Node's
+normal hoisted dependency lookup otherwise lets the missing-Vite case find an
+unrelated installed Vite after removing the fixture's local dependency. The
+fixture uses the existing packed-consumer and dev-mcp admission pattern: prefer
+the temporary directory, fall back to the home directory, and require a clean
+TMPDIR when neither parent is isolated. Runtime lookup and assertions stay intact.
+
+| Behavior / invariant | Trigger | Positive | Negative / failure | Actor / context | Executor / transaction | Runtime / dialect | External edge | Test level / validation |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| Missing Vite is truly absent | Remove fixture node_modules | Launcher reports missing Vite with status 1 | Unrelated ancestor Vite cannot satisfy the fixture | Real CLI child process | N/A: disposable filesystem fixture | Node26; SQL N/A | Normal Node dependency lookup | Existing CLI process test |
+| Fixture retains process behavior | Dev/build/vite commands | Arguments, environment, stderr and signal contracts hold | Unsafe/missing executable remains rejected | Fixture application | N/A: isolated child processes | Node26; SQL N/A | Fake local Vite and built CLI entry | All eight process tests |
+
+Baseline ordinary execution reproduced seven passes and one failure: the absent
+Vite case found the unowned `/tmp/node_modules/vite`, returning status 0 instead
+of 1. An owned TMPDIR with clean ancestors passes all eight tests before the fix,
+confirming fixture contamination. The corrected fixture passes the same eight
+tests under the ordinary environment. No assertion, runtime dependency lookup,
+unowned installation or packaged application artifact is changed.
+
+```sh
+pnpm --filter @happyvertical/smrt-cli exec vitest run src/app/__tests__/cli-process.test.ts
+```
+
+Full baseline, isolated diagnostic and corrected outputs are retained in release
+evidence under `search/cli-fixture-base.log`,
+`search/cli-fixture-clean-ancestor.log` and `search/cli-fixture-fixed-r2.log`.
+The release coordinator owns combined source acceptance.

package/cookbooks/bakery.cookbook.json

@@ -0,0 +1,187 @@
+{
+  "$schema": "https://s-m-r-t.dev/schemas/cookbook/v1.json",
+  "version": 1,
+  "theme": {
+    "custom": {
+      "primary": "#b45309",
+      "fontFamily": "Georgia"
+    }
+  },
+  "recipes": [
+    "commerce.customers",
+    "commerce.invoicing",
+    "commerce.purchases",
+    "commerce.sales",
+    "commerce.vendors",
+    "commerce.wholesale",
+    "inventory.stock",
+    "ledgers.bookkeeping",
+    "products.ingredients",
+    "products.simple"
+  ],
+  "features": [
+    "@happyvertical/smrt-commerce:ProductionOrder"
+  ],
+  "policies": [
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Customer",
+      "fieldName": "paymentTerms",
+      "scopeType": "app",
+      "defaultValue": "\"Net 15\""
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Invoice",
+      "fieldName": "currency",
+      "scopeType": "app",
+      "defaultValue": "\"USD\""
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Invoice",
+      "fieldName": "terms",
+      "scopeType": "app",
+      "defaultValue": "\"Net 15\""
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Order",
+      "fieldName": "terms",
+      "scopeType": "app",
+      "defaultValue": "\"Net 15\""
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:ProductionOrder",
+      "fieldName": "channelId",
+      "scopeType": "app",
+      "visibility": "hidden"
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:ProductionOrder",
+      "fieldName": "customerId",
+      "scopeType": "app",
+      "visibility": "hidden"
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:ProductionOrder",
+      "fieldName": "expiryDate",
+      "scopeType": "app",
+      "visibility": "hidden"
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:ProductionOrder",
+      "fieldName": "vendorId",
+      "scopeType": "app",
+      "visibility": "hidden"
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:WholesaleOrder",
+      "fieldName": "terms",
+      "scopeType": "app",
+      "defaultValue": "\"Net 15\""
+    }
+  ],
+  "layout": {
+    "version": 1,
+    "sectionOrder": [
+      "custom:shop",
+      "custom:wholesale",
+      "custom:kitchen",
+      "custom:buying",
+      "section:accounting"
+    ],
+    "itemOrder": {
+      "custom:shop": [
+        "item:commerce:Order",
+        "item:commerce:Customer"
+      ],
+      "custom:wholesale": [
+        "item:commerce:WholesaleOrder",
+        "item:commerce:Invoice",
+        "item:commerce:Payment"
+      ],
+      "custom:kitchen": [
+        "item:products:Product",
+        "item:products:Product:ingredients",
+        "item:inventory:StockLevel",
+        "item:commerce:ProductionOrder"
+      ],
+      "custom:buying": [
+        "item:commerce:Vendor",
+        "item:commerce:PurchaseOrder"
+      ]
+    },
+    "hidden": [
+      "item:inventory:InventoryLocation",
+      "item:inventory:StockMovement"
+    ],
+    "moved": {
+      "item:commerce:Order": "custom:shop",
+      "item:commerce:Customer": "custom:shop",
+      "item:commerce:WholesaleOrder": "custom:wholesale",
+      "item:commerce:Invoice": "custom:wholesale",
+      "item:commerce:Payment": "custom:wholesale",
+      "item:products:Product": "custom:kitchen",
+      "item:inventory:StockLevel": "custom:kitchen",
+      "item:commerce:ProductionOrder": "custom:kitchen",
+      "item:commerce:Vendor": "custom:buying",
+      "item:commerce:PurchaseOrder": "custom:buying",
+      "item:products:Product:ingredients": "custom:kitchen"
+    },
+    "customSections": [
+      {
+        "id": "custom:shop",
+        "label": "Shop"
+      },
+      {
+        "id": "custom:wholesale",
+        "label": "Wholesale"
+      },
+      {
+        "id": "custom:kitchen",
+        "label": "Kitchen"
+      },
+      {
+        "id": "custom:buying",
+        "label": "Buying"
+      }
+    ],
+    "items": {
+      "item:commerce:Order": {
+        "label": "Orders",
+        "description": "Orders from your shop and website customers."
+      },
+      "item:commerce:WholesaleOrder": {
+        "label": "Cafe orders",
+        "description": "Standing and one-off orders from cafes and shops."
+      },
+      "item:inventory:StockLevel": {
+        "label": "Stock",
+        "description": "Baked goods and supplies on hand today."
+      },
+      "item:commerce:ProductionOrder": {
+        "label": "Batches",
+        "description": "What you plan to bake, with the amounts and the day."
+      },
+      "item:commerce:Vendor": {
+        "label": "Suppliers",
+        "description": "The mills, dairies and suppliers you buy from."
+      },
+      "item:products:Product:ingredients": {
+        "label": "Ingredients",
+        "description": "Flour, butter, sugar and the rest, with costs and units."
+      }
+    },
+    "sections": {
+      "custom:shop": {
+        "icon": "shoppingBag"
+      },
+      "custom:wholesale": {
+        "icon": "briefcase"
+      },
+      "custom:kitchen": {
+        "icon": "package"
+      },
+      "custom:buying": {
+        "icon": "truck"
+      }
+    }
+  }
+}

package/cookbooks/mechanic.cookbook.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "https://s-m-r-t.dev/schemas/cookbook/v1.json",
+  "version": 1,
+  "theme": {
+    "preset": "smrt"
+  },
+  "recipes": [
+    "commerce.customers",
+    "commerce.estimates",
+    "commerce.invoicing",
+    "commerce.purchases",
+    "commerce.sales",
+    "commerce.vendors",
+    "events.calendar",
+    "inventory.stock",
+    "ledgers.bookkeeping",
+    "products.simple"
+  ],
+  "features": [],
+  "policies": [
+    {
+      "objectRef": "@happyvertical/smrt-commerce:ContractLineItem",
+      "fieldName": "taxRate",
+      "scopeType": "app",
+      "defaultValue": "0.0825"
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Customer",
+      "fieldName": "creditLimit",
+      "scopeType": "app",
+      "visibility": "hidden"
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Customer",
+      "fieldName": "customerType",
+      "scopeType": "app",
+      "visibility": "hidden"
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Customer",
+      "fieldName": "paymentTerms",
+      "scopeType": "app",
+      "defaultValue": "\"Due on receipt\""
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Estimate",
+      "fieldName": "terms",
+      "scopeType": "app",
+      "defaultValue": "\"Due on receipt\""
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Invoice",
+      "fieldName": "currency",
+      "scopeType": "app",
+      "defaultValue": "\"USD\""
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Invoice",
+      "fieldName": "terms",
+      "scopeType": "app",
+      "defaultValue": "\"Due on receipt\""
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:InvoiceLineItem",
+      "fieldName": "taxRate",
+      "scopeType": "app",
+      "defaultValue": "0.0825"
+    },
+    {
+      "objectRef": "@happyvertical/smrt-commerce:Order",
+      "fieldName": "terms",
+      "scopeType": "app",
+      "defaultValue": "\"Due on receipt\""
+    }
+  ],
+  "layout": {
+    "version": 1,
+    "sectionOrder": [
+      "custom:jobs",
+      "custom:parts",
+      "custom:billing",
+      "custom:schedule",
+      "section:accounting"
+    ],
+    "itemOrder": {
+      "custom:jobs": [
+        "item:commerce:Estimate",
+        "item:commerce:Order",
+        "item:commerce:Customer"
+      ],
+      "custom:parts": [
+        "item:products:Product",
+        "item:inventory:StockLevel",
+        "item:commerce:Vendor",
+        "item:commerce:PurchaseOrder"
+      ],
+      "custom:billing": [
+        "item:commerce:Invoice",
+        "item:commerce:Payment"
+      ],
+      "custom:schedule": [
+        "item:events:Event",
+        "item:events:EventType"
+      ]
+    },
+    "hidden": [
+      "item:events:EventSeries",
+      "item:inventory:InventoryLocation",
+      "item:inventory:StockMovement"
+    ],
+    "moved": {
+      "item:commerce:Estimate": "custom:jobs",
+      "item:commerce:Order": "custom:jobs",
+      "item:commerce:Customer": "custom:jobs",
+      "item:products:Product": "custom:parts",
+      "item:inventory:StockLevel": "custom:parts",
+      "item:commerce:Vendor": "custom:parts",
+      "item:commerce:PurchaseOrder": "custom:parts",
+      "item:commerce:Invoice": "custom:billing",
+      "item:commerce:Payment": "custom:billing",
+      "item:events:Event": "custom:schedule",
+      "item:events:EventType": "custom:schedule"
+    },
+    "customSections": [
+      {
+        "id": "custom:jobs",
+        "label": "Jobs"
+      },
+      {
+        "id": "custom:parts",
+        "label": "Parts"
+      },
+      {
+        "id": "custom:billing",
+        "label": "Billing"
+      },
+      {
+        "id": "custom:schedule",
+        "label": "Schedule"
+      }
+    ],
+    "items": {
+      "item:commerce:Estimate": {
+        "label": "Quotes",
+        "description": "Quotes for repairs, ready to become work orders once approved."
+      },
+      "item:commerce:Order": {
+        "label": "Work orders",
+        "description": "Every job in the shop, from drop-off to pick-up."
+      },
+      "item:products:Product": {
+        "label": "Parts",
+        "description": "The parts you sell and fit, with prices."
+      },
+      "item:inventory:StockLevel": {
+        "label": "Parts on hand",
+        "description": "Parts on the shelf, so you know what to reorder."
+      },
+      "item:commerce:Vendor": {
+        "label": "Suppliers",
+        "description": "The parts suppliers you buy from, with terms and contacts."
+      },
+      "item:commerce:PurchaseOrder": {
+        "label": "Parts orders",
+        "description": "Parts you have ordered and when they arrive."
+      },
+      "item:events:Event": {
+        "label": "Appointments",
+        "description": "Bookings on the shop calendar, by day and bay."
+      },
+      "item:events:EventType": {
+        "label": "Appointment types",
+        "description": "The kinds of service you book, like an oil change or inspection."
+      }
+    },
+    "sections": {
+      "custom:jobs": {
+        "icon": "wrench"
+      },
+      "custom:parts": {
+        "icon": "package"
+      },
+      "custom:billing": {
+        "icon": "receipt"
+      },
+      "custom:schedule": {
+        "icon": "calendar"
+      }
+    }
+  }
+}