fimo 2.2.0-staging.1 → 2.2.0-staging.10

package/README.md

@@ -27,9 +27,10 @@ Run the CLI with `npx` — no global install, always the latest:
 
 ```bash
 npx fimo@latest login
-npx fimo@latest init my-site                 # default React Router scaffold
+# default Next.js App Router scaffold
+npx fimo@latest init my-site
+# or: npx fimo@latest init my-react-site --framework react-router
 # or: npx fimo@latest init my-astro-site --framework astro
-# or: npx fimo@latest init my-next-site --framework nextjs
 # or: npx fimo@latest init my-svelte-site --framework sveltekit
 cd my-site
 ```

package/assets/agent-templates/_default/config.yaml

@@ -2,5 +2,6 @@
 # See https://fimo.dev/docs/agents/bundle for the full reference.
 version: 1
 description: 'A new Fimo agent. Edit this tagline to describe what it does.'
+model: openai/gpt-5.6-luna
 triggers:
   - type: manual

package/assets/agent-templates/broken-link-sweeper/config.yaml

@@ -1,5 +1,6 @@
 version: 1
 description: 'Crawl the published site and flag broken outbound links in a weekly report.'
+model: openai/gpt-5.6-luna
 
 runtime:
   cloud: true

package/assets/agent-templates/content-translator/config.yaml

@@ -1,5 +1,6 @@
 version: 1
 description: 'Translate CMS content into the project locales whenever an entry is published.'
+model: openai/gpt-5.6-luna
 data_sources:
   - main
 

package/assets/agent-templates/post-deploy-check/config.yaml

@@ -1,5 +1,6 @@
 version: 1
 description: 'Probe routes and inspect logs after a deploy; report any issues to email recipients.'
+model: openai/gpt-5.6-luna
 data_sources:
   - prod
 

package/assets/agent-templates/seo-audit/config.yaml

@@ -1,5 +1,6 @@
 version: 1
 description: "Audit the project's pages for SEO health and write a markdown report."
+model: openai/gpt-5.6-luna
 # Read from main env. Switch to prod when running the audit against the
 # live site (M13 keeps data_sources here so M16's sandbox adapter can
 # bind the right Fimo API base URL).

package/assets/skills/fimo-cli/SKILL.md

@@ -52,7 +52,7 @@ A project can have multiple **Branches** — each is a git branch _plus_ its own
 fimo login                                     # authenticate via browser
 fimo skills install                            # install the global Fimo skill for your AI tools
 fimo init my-site --org <id>                   # one-stop setup: sign in, create/link a project, install deps + skills. Use the org **id** from `fimo orgs list`, NOT the slug.
-fimo init my-site --starter fimo-site@1 --org <id> --yes --no-skills  # opt-in content-led starter for a new project
+fimo init my-react-site --framework react-router --org <id> --yes --no-skills  # canonical React Router template
 fimo init --project-id <id> my-site            # set up a project by ID: scaffold a newly created project or clone existing code
 fimo clone                                     # interactively choose an existing project to clone locally
 cd my-site                                     # then load skills on demand: fimo skills get fimo-code
@@ -64,6 +64,8 @@ fimo deploy                                    # ON-DEMAND: hosted project previ
 fimo deploy --publish                          # ON-DEMAND: publish live (only when the developer says "ship it")
 ```
 
+New projects use the Next.js App Router template by default. Fimo's canonical React Router template is selected explicitly with `--framework react-router`; use `--framework vite` for a React SPA.
+
 The working loop is local: run the app with the project's package-manager `dev` script (`pnpm dev` / `npm run dev` / `yarn dev` / `bun dev` — match the lockfile), ask the developer what they want, edit, and iterate against the live localhost server. Outside the first-time onboarding rule below, `fimo deploy` is **not** a required final step — reach for it only when the developer wants a hosted project preview or to go live, and only on their signal (see `references/deploy.md`).
 
 `fimo validate` is the single entrypoint for "prove this project is ready" — it covers schema/form codegen, route metadata checks, lint, and missing label checks for `i18n.defaultLocale` from `.fimo/config.json` (fallback: `en`). Use `fimo labels set` / `set-many` to create or update label values in the DB. The underlying phases are also available individually under the hidden `fimo scripts` namespace for advanced/debug use.
@@ -76,7 +78,7 @@ Keep `fimo validate --json` at the front of the project's `build` script, which
 
 Load the matching reference when the user's request fires its trigger. Recipes that involve writing code also need the `fimo-code` skill's package references — they're called out where relevant.
 
-- "Create a new Fimo project / scaffold a site / start a new website / add the opt-in content starter / link an existing project locally" → `references/init.md`
+- "Create a new Fimo project / scaffold a site / start a new website / link an existing project locally" → `references/init.md`
 - "Add a content type / blog / products / content schemas / CMS" → `references/content.md` (workflow) **+ run `fimo skills get fimo-code --ref content/schema` and load the detected framework reference**
 - "Declare Pages routes / configure Pages sources or route params / control what Studio shows for a route" → `references/pages.md`
 - "Add a contact / signup / feedback / newsletter form" → `references/forms.md` (workflow) **+ run `fimo skills get fimo-code --ref forms` for the JSON spec and generated client**
@@ -140,8 +142,6 @@ These fire at specific moments in the project lifecycle. **Surface them proactiv
 - **Running `fimo deploy` just to get the current preview URL** — that's a commit + push + sandbox sync when only destination resolution is needed. Use `fimo preview url` instead. See `references/preview.md`.
 - **Using `fimo deploy --publish` casually** — `--publish` makes the site live to the public. Plain `fimo deploy` (preview) is the default. Use `--publish` only when the user says "ship it" / "go live" / "publish".
 - **Bare `fimo init` in a non-interactive shell** — will hang. Always pass `[dir]`, `--no-install` (or `--install`), `--no-skills` (or `--skills`), and `--org`/`--agents` as needed explicitly when scripted.
-- **Using a starter on an existing project** — `--starter` is create-new only. Keep `--project-id` flows blank and use explicit content/form/label commands when changing an existing project.
-- **Treating a starter as a permanent demo tenant** — starters are opt-in seed data in the new project, not a global default. Keep starter agents manual-only; do not add schedules or webhooks unless the project owner explicitly asks for automation.
 - **Hardcoding content / strings / images in code** — that's what schemas, `t()`, and the media library are for. See the `fimo-code` skill's anti-patterns.
 - **Adding another deploy tool (Vercel, Netlify, Cloudflare Pages)** — Fimo handles deploys; don't bolt another platform on.
 - **Committing secrets** — hidden values use `fimo secrets`; public browser-safe values use `fimo vars`. Local env files are ignored and must not become deploy inputs.

package/assets/skills/fimo-cli/references/agents.md

@@ -40,6 +40,7 @@ fimo agents secrets remove <name> <KEY> [-C <dir>]
 
 - **`list-templates`** — list the bundled starter templates with the first line of each template's `GOAL.md` as a summary. Ships with the CLI binary; no API call. The five bundled templates are `_default`, `seo-audit`, `content-translator`, `broken-link-sweeper`, `post-deploy-check`.
 - **`create <name>`** — scaffold `.fimo/agents/<name>/` from a template (default `_default`, a minimal valid bundle with a manual trigger). `--description <text>` writes a one-line tagline into the scaffolded `config.yaml` (surfaces in the dashboard's agents list). When run **without** `-C`, it requires the cwd to be inside a real Fimo project (walks up for `.fimo/project.json` or legacy `.fimo.settings.json`) and errors out cleanly otherwise, so it never leaks an agent bundle into a stray cwd. If the template declares capabilities, an install-consent flow runs after the copy (`--quiet` skips it; critical caps still abort).
+- Every generated `config.yaml` includes `model: openai/gpt-5.6-luna`. Change that top-level value to another supported Fimo text model when needed; bundles without `model` keep the Luna fallback. Deploy after changing it because cloud runs use the deployed bundle.
 - **`list`** — list the agents declared under `<project>/.fimo/agents/` (or legacy root `agents/`), with each one's trigger types and capability count. Local — the bundle list is the source of truth even if the project isn't linked yet.
 - **`validate [name]`** — run the full validation pipeline: parse → capability vocabulary → composition (cycle / missing sub-agents / invalid grants) → semantic + Fimo project config policy checks. Omit `name` to validate every bundle. `--json` emits a structured `ValidationReport` for CI; exit code is non-zero on any failure.
 - **`secrets add/remove/list`** — edit or inspect the agent's requested secret names in `.fimo/agents/<name>/config.yaml` (or legacy root). These commands do not create, rotate, or reveal secret values. Store values with `fimo secrets add`; run `fimo agents validate` to check that required requested secrets exist in the project. See `references/project-vars-and-secrets.md`.
@@ -241,7 +242,7 @@ Example for a content editor that can read and update entries but cannot change
 
 ```bash
 fimo agents run <name> [--branch <branch>] [--project <id>] [--skip-drift-check] [-C <dir>]
-fimo agents runs <name> [--limit <n>] [--branch <branch>] [--project <id>] [-C <dir>]
+fimo agents runs <name> [--limit <n>] [--cursor <cursor>] [--all-pages] [--branch <branch>] [--project <id>] [-C <dir>]
 fimo agents report <name> [--session <id>] [--branch <branch>] [--project <id>] [-C <dir>]
 fimo agents logs <name> [--session <id>] [--project <id>] [-C <dir>]
 ```

package/assets/skills/fimo-cli/references/assets.md

@@ -96,9 +96,12 @@ fimo assets list --search "wolf"
 fimo assets list --search "hero" --image
 fimo assets list --search "logo" --type file --sort-by createdAt
 
-fimo assets list --limit 50 --offset 0                    # paging
+fimo assets list --limit 50 --cursor <next-cursor>        # next page
+fimo assets list --all-pages                              # every remaining page
 ```
 
+The response includes `nextCursor` when another page exists. Keep the same filters when continuing. `--offset` remains a compatibility alias for existing scripts.
+
 The `--search` query matches:
 
 - `name` (file name)

package/assets/skills/fimo-cli/references/content.md

@@ -69,7 +69,7 @@ Use singular commands for one entry. Bulk create and per-entry bulk update also
 ```bash
 fimo entries create <TypeName> --body '<json>'
 fimo entries create <TypeName> --locale es --document-id <documentId> --body '<json>'
-fimo entries list <TypeName> [--limit N] [--offset N] [--search Q] [--where JSON] [--sort F] [--fields FIELDS] [--populate FIELDS]
+fimo entries list <TypeName> [--limit N] [--cursor CURSOR] [--all-pages] [--search Q] [--where JSON] [--sort F] [--fields FIELDS] [--populate FIELDS]
 fimo entries list <TypeName> --locale es
 fimo entries get <TypeName> <id> [--locale es]
 fimo entries update <TypeName> <id> [--locale es] --body '<json>'
@@ -90,12 +90,12 @@ fimo entries list BlogPost --where '{"featured":true}' --sort -publishedAt
 fimo entries list BlogPost --where '{"rank":{"$gte":3}}' --sort rank
 fimo entries list BlogPost --where '{"__fimo":{"contentType":{"$eq":"BlogPost"}}}'
 fimo entries list BlogPost --search "launch"
-fimo entries list BlogPost --limit 10 --offset 20 --sort title
+fimo entries list BlogPost --limit 10 --cursor <next-cursor> --sort title
 fimo entries list BlogPost --fields slug,title,excerpt,coverImage --sort -publishedAt --limit 12
 fimo entries list BlogPost --fields slug,title,author --populate author
 ```
 
-Use the canonical read query flags: `--search`, `--sort`, `--where`, `--limit`, `--offset`, `--fields`, and `--populate`.
+Use the canonical read query flags: `--search`, `--sort`, `--where`, `--limit`, `--cursor`, `--all-pages`, `--fields`, and `--populate`. `--offset` remains a compatibility alias for existing scripts.
 `--where` is a JSON object keyed by schema field name. Simple values mean equality and stay typed inside the JSON (`{"featured":true}`, `{"category":"react"}`, `{"rank":{"$gte":3}}`); operator objects support `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$contains`, `$startsWith`, and `$null`, subject to the field type. Public Fimo-owned metadata lives under `__fimo`; currently `__fimo.contentType` is filterable.
 
 Reference filters take the target `id` string (`{"author":"750e..."}`). On a to-many field, `$eq` and `$contains` mean membership, `$in` means any listed target is present, `$ne` and `$nin` mean none are present, and `$null: true` means empty or missing. Reference fields cannot be sorted; use `--sort field` / `--sort -field` on scalar fields.

package/assets/skills/fimo-cli/references/deploy.md

@@ -50,11 +50,11 @@ Public project variables managed with `fimo vars add` and `fimo vars update` are
 
 ## Diagnose a failed publication
 
-Use the publication ID returned by the failed command: run `fimo publish inspect <id> --json` for its durable status, then `fimo publish logs <id> --json` for a bounded build-log tail. Logs come from the hosting provider and may be unavailable after its deployment is reclaimed.
+Use the publication ID returned by the failed command: run `fimo publish inspect <id> --json` for its durable status, then `fimo publish logs <id> --json` for a bounded build-log tail. Use `fimo publish list --cursor <cursor>` to continue through older attempts or `--all-pages` to fetch the complete retained history. `--before` remains a compatibility alias. Logs come from the hosting provider and may be unavailable after its deployment is reclaimed.
 
 ## Diagnose a failed preview deploy
 
-If the sandbox fails to install dependencies or start the app, run `fimo logs --json` before retrying. Read the newest install and dev-server events first; when the response is truncated, use its `previousCursor` as `fimo logs --before <cursor> --json` to fetch the preceding page. Do not recreate or replace the sandbox before collecting logs, because that can discard the failure evidence.
+If the sandbox fails to install dependencies or start the app, run `fimo logs --json` before retrying. Read the newest install and dev-server events first; when the response is truncated, use its `previousCursor` as `fimo logs --cursor <cursor> --json` to fetch the preceding page, or use `--all-pages` to fetch every retained page. `--before` remains a compatibility alias. Do not recreate or replace the sandbox before collecting logs, because that can discard the failure evidence.
 
 When Preview reports blocked dependency build scripts, treat that as a project security-policy repair, not a transient sandbox failure. Review every named package before approving it, then use the package manager's narrow project-owned mechanism:
 

package/assets/skills/fimo-cli/references/forms.md

@@ -29,11 +29,13 @@ Notification recipients for form submissions are configured in the Fimo web UI,
 After a form is live and users have filled it out, inspect submissions from the terminal:
 
 ```bash
-fimo forms submissions list <formIdOrName> [--limit 50] [--offset 0] [--search "<q>"] [--sort asc|desc]
+fimo forms submissions list <formIdOrName> [--limit 50] [--cursor CURSOR] [--all-pages] [--search "<q>"] [--sort asc|desc]
 fimo forms submissions get  <formIdOrName> <submissionId>
 fimo forms submissions stats <formIdOrName>
 ```
 
+The list response includes `nextCursor` when another page exists. `--offset` remains a compatibility alias for existing scripts.
+
 - `<formIdOrName>` accepts either the form's UUID or its `name` (the same name in the JSON file). Names that don't resolve to exactly one form return an error.
 - `list` returns `{ data: [...], total }`. Newest-first by default; pass `--sort asc` to reverse.
 - `search` matches against submission contents server-side.

package/assets/skills/fimo-cli/references/history.md

@@ -28,6 +28,7 @@ there is no local `.fimo/project.json`.
 
 ```bash
 fimo history list --limit 20 --cursor <cursor>
+fimo history list --all-pages
 ```
 
 The list also reports compressed snapshot usage and the current retention period. Restore points expire after 14 days on Free and pay-as-you-go plans, or 90 days on Premium. The expiry is fixed when each point is created.

package/assets/skills/fimo-cli/references/init.md

@@ -11,40 +11,40 @@ fimo init [dir] [options]
 `fimo init` runs the full onboarding in one shot:
 
 1. **Signs in automatically** — if there's no session it opens the browser loopback login. In `--json` / non-TTY with no session it fails with `NOT_AUTHENTICATED` (run `fimo login` first).
-2. **Resolves the project** — with `--project-id <id>` it sets up the named Fimo project: a project with no code yet is scaffolded as a fresh site, while an existing repository is cloned. Without it, `init` creates a NEW project. An interactive TTY shows a "Create new / Link existing" picker; non-interactive shells default to create-new. New projects use React Router by default; `--framework vite`, `--framework astro`, `--framework nextjs`, and `--framework sveltekit` select minimal framework-native shells. An optional `--starter fimo-site@1` adds a content-led starter only to a newly created project without `--project-id`.
+2. **Resolves the project** — with `--project-id <id>` it sets up the named Fimo project: a project with no code yet is scaffolded as a fresh site, while an existing repository is cloned. Without it, `init` creates a NEW project. An interactive TTY shows a "Create new / Link existing" picker; non-interactive shells default to create-new. New projects use the Next.js App Router by default; `--framework react-router`, `--framework vite`, `--framework astro`, and `--framework sveltekit` select the other minimal framework-native shells.
 3. **Installs dependencies** — prompts for the package manager, or honor `--package-manager <pm>` / `--no-install`.
 4. **Optionally sets up Fimo skills** — confirm prompt, or `--skills` / `--no-skills`.
 
 Generated pnpm projects pin `pnpm@10.26.0` and carry project-owned `pnpm-workspace.yaml#strictDepBuilds: true` and `#allowBuilds` settings. Generated Bun projects trust the same required packages through `package.json#trustedDependencies`. Keep the selected package manager's policy committed. When adding a dependency with an install script, review it before extending that policy; never replace it with a blanket allow-all install.
 
-| Flag                         | Required                      | Purpose                                                                                                                                                        |
-| ---------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `[dir]` positional           | yes in non-TTY for create-new | Target directory (e.g. `my-site`)                                                                                                                              |
-| `--project-id <id>`          | no                            | Set up the named Fimo project: scaffold and push a fresh site when it has no code yet, otherwise clone it.                                                     |
-| `--org <id>`                 | no                            | Target organization **id** when creating (use the `ID` column from `fimo orgs list`, NOT the slug). Picker shown interactively if omitted and TTY.             |
-| `--branch <name>`            | no                            | Branch to check out when linking an existing project (defaults to `main`).                                                                                     |
-| `--env <name>`               | no                            | Compatibility alias for `--branch <name>`.                                                                                                                     |
-| `--framework <framework>`    | no                            | New-project scaffold: `react-router` (default), `vite` (React SPA), `astro`, `nextjs` (App Router), or `sveltekit`. Existing repositories are preserved.       |
-| `--starter <id>`             | no                            | Opt-in project starter for create-new (currently `fimo-site@1`). It seeds CMS content, labels, a contact form, and manual-only agents. Rejects `--project-id`. |
-| `--package-manager <pm>`     | no                            | `npm` \| `pnpm` \| `yarn` \| `bun`.                                                                                                                            |
-| `--install` / `--no-install` | yes in non-TTY                | Install deps after checkout (or skip it).                                                                                                                      |
-| `--skills` / `--no-skills`   | yes in non-TTY                | Install the global Fimo skill (or skip it).                                                                                                                    |
-| `--agents <list>`            | no                            | Comma-separated agent IDs (e.g. `claude-code,cursor`). Pass `none` to skip installing the global skill.                                                        |
-| `-a, --agent <id>`           | alternative                   | Repeatable form: `-a claude-code -a cursor`.                                                                                                                   |
-| `--template-root <path>`     | no                            | Override the bundled template (development only).                                                                                                              |
-| `-y, --yes`                  | no                            | Run non-interactively using defaults (no prompts).                                                                                                             |
+| Flag                         | Required                      | Purpose                                                                                                                                                 |
+| ---------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `[dir]` positional           | yes in non-TTY for create-new | Target directory (e.g. `my-site`)                                                                                                                       |
+| `--project-id <id>`          | no                            | Set up the named Fimo project: scaffold and push a fresh site when it has no code yet, otherwise clone it.                                              |
+| `--org <id>`                 | no                            | Target organization **id** when creating (use the `ID` column from `fimo orgs list`, NOT the slug). Picker shown interactively if omitted and TTY.      |
+| `--branch <name>`            | no                            | Branch to check out when linking an existing project (defaults to `main`).                                                                              |
+| `--env <name>`               | no                            | Compatibility alias for `--branch <name>`.                                                                                                              |
+| `--framework <framework>`    | no                            | New-project scaffold: `nextjs` (App Router, default), `react-router`, `vite` (React SPA), `astro`, or `sveltekit`. Existing repositories are preserved. |
+| `--package-manager <pm>`     | no                            | `npm` \| `pnpm` \| `yarn` \| `bun`.                                                                                                                     |
+| `--install` / `--no-install` | yes in non-TTY                | Install deps after checkout (or skip it).                                                                                                               |
+| `--skills` / `--no-skills`   | yes in non-TTY                | Install the global Fimo skill (or skip it).                                                                                                             |
+| `--agents <list>`            | no                            | Comma-separated agent IDs (e.g. `claude-code,cursor`). Pass `none` to skip installing the global skill.                                                 |
+| `-a, --agent <id>`           | alternative                   | Repeatable form: `-a claude-code -a cursor`.                                                                                                            |
+| `--template-root <path>`     | no                            | Override the bundled template (development only).                                                                                                       |
+| `-y, --yes`                  | no                            | Run non-interactively using defaults (no prompts).                                                                                                      |
 
 In a non-TTY shell the create-new path requires `[dir]`, `--install` / `--no-install`, and `--skills` / `--no-skills` (and `--org` if you have no active org and belong to multiple orgs). Without them the command exits with `Cannot prompt in a non-interactive shell.`
 
-### Non-interactive starter setup
+### Non-interactive setup
 
 Use explicit flags when a script or agent owns the flow. `--json` gives the
 caller one stable result envelope; `--yes` is useful when running in a TTY but
-is not required in a pipe or CI shell. The starter is never selected by default.
+is not required in a pipe or CI shell. The default scaffold is the Next.js App
+Router template. Select the canonical React Router template explicitly with
+`--framework react-router`.
 
 ```bash
 fimo --json init my-site \
-  --starter fimo-site@1 \
   --org <organizationId> \
   --no-install \
   --no-skills \
@@ -52,22 +52,18 @@ fimo --json init my-site \
   --yes
 ```
 
-The command creates the project, copies the starter overlay, seeds its `HomePage`
-singleton, `contact` form, and labels in `main`, writes the form id into
-`src/forms/contact.json`, and commits the starter agents as manual-only bundles.
-`--starter` is create-new only; an existing-project command such as
-`fimo init --project-id <id> --starter fimo-site@1` fails before cloning or
-writing anything. If dependencies were skipped, install them and run
-`fimo validate` before starting the app so generated clients are present.
+If dependencies were skipped, install them and run `fimo validate` before
+starting the app so generated clients are present.
 
 > **Zero-install:** the selected `fimo init` invocation needs no global install. `fimo projects create` is also an alias of `fimo init` (create-new path).
 
 ### Choose the application framework
 
-Omit `--framework` for the existing React Router scaffold, or select a
-minimal framework-native shell explicitly:
+Omit `--framework` for the default Next.js App Router shell, or select a
+different framework explicitly:
 
 ```bash
+fimo init my-react-site --framework react-router --org <organizationId>
 fimo init my-vite-site --framework vite --org <organizationId>
 fimo init my-astro-site --framework astro --org <organizationId>
 fimo init my-next-site --framework nextjs --org <organizationId>
@@ -80,6 +76,10 @@ boundary that keeps the default locale unprefixed. The Astro shell also includes
 content-backed example with static, on-demand, and dynamic routes; the other shells intentionally
 contain no schema, labels, or designed website.
 
+The React Router shell is the canonical Fimo React template for framework mode;
+select it with `--framework react-router` when a project should use React Router
+instead of the default Next.js App Router shell.
+
 Set the primary locale from the request: when several are explicitly named, use the first as default;
 if none is requested, keep `en` and tell the user. Update `.fimo/config.json#i18n`, the framework-native
 locale boundary, matcher, and HTML language default. Do not keep `en` solely because the shell starts
@@ -89,7 +89,6 @@ After init, load the project rules and `fimo-code` to build the requested site.
 If you replace a shell's code with a site that uses another framework or none,
 fix `runtime.framework` in the same change
 (`fimo-code` → `references/frameworks/hosting.md`).
-The current `fimo-site@1` content starter supports React Router only.
 
 For `--agents`, pass the AI tool you're running in: `--agents=claude-code` for Claude Code, `--agents=cursor` for Cursor, `--agents=codex` for Codex, etc. When the flag is omitted, env-var detection of the invoking harness (e.g. `CLAUDECODE` / `CLAUDE_CODE_ENTRYPOINT` → claude-code) auto-targets that agent; other agents must be selected explicitly via `--agents`/`-a` or the interactive picker.
 
@@ -109,21 +108,13 @@ fimo link <projectId> --relink
 
 `fimo init` (create-new path) scaffolds:
 
-- The selected project shell: React Router by default, a native React SPA with `--framework vite`, Astro with `--framework astro`, Next.js App Router with `--framework nextjs`, or SvelteKit with `--framework sveltekit`
+- The selected project shell: Next.js App Router by default, React Router with `--framework react-router`, a native React SPA with `--framework vite`, Astro with `--framework astro`, or SvelteKit with `--framework sveltekit`
 - `.fimo/project.json` — links this directory to the remote project (read-only after creation)
 - `.fimo/config.json` — project, optional Studio Pages route metadata, locale, SEO, and agent policy
 - `.fimo/agents/` — versioned agent bundles
 - `AGENTS.md` + `CLAUDE.md` — project rules (from the template) read by AGENTS.md-compatible tools and Claude Code. Both point the agent at `fimo skills get` to load the real skills on demand.
 - A git repository with `fimo` as the remote, and — after dependencies install — an initial commit (including the lockfile) plus an initial push
 
-When `--starter fimo-site@1` is supplied, the overlay also includes a
-content-backed homepage, `src/schemas/HomePage.json`, a `contact` form spec,
-nine English labels, and two read-only agent bundles (`site-review` and
-`content-guide`). The seed is opt-in and scoped to the new project; the default
-blank template and all existing-project flows remain unchanged. Starter agents
-declare only a manual trigger so copying them does not create schedules or
-webhooks.
-
 Nothing is written into per-agent skill dirs: the rich skills are fetched on demand via `fimo skills get <name>`, never copied into the project. `fimo init` separately installs the small global `fimo` bootstrap skill for the agents you select (machine-wide, not in the project) unless you pass `--no-skills`. For other agents' rule-file variants (`.cursor/rules/fimo.mdc`, `.windsurfrules`, `GEMINI.md`), run `fimo rules sync`. See `references/agent-setup.md`.
 
 Codex, OpenCode, Aider, and similar AGENTS.md-native tools work directly off AGENTS.md.

package/assets/skills/fimo-cli/references/schedules.md

@@ -22,7 +22,7 @@ fimo schedules resume <schedule>
 fimo schedules run <schedule>
 fimo schedules run <schedule> --no-wait
 fimo schedules runs <schedule> --limit 25 --status failed
-fimo schedules runs <schedule> --all
+fimo schedules runs <schedule> --all-pages
 fimo schedules runs show <run-id>
 fimo schedules delete <schedule>
 ```
@@ -59,9 +59,11 @@ Run history is cursor-paginated:
 fimo schedules runs nightly --limit 50
 fimo schedules runs nightly --cursor <cursor>
 fimo schedules runs nightly --status succeeded
-fimo schedules runs nightly --all
+fimo schedules runs nightly --all-pages
 ```
 
+`--all` remains a compatibility alias for existing scripts.
+
 Run detail includes status, timing, trigger, exit/error information, retained output, output retention metadata, and secret snapshot metadata. Output is capped and redacted before it is returned.
 
 ## JSON

package/assets/skills/fimo-cli/references/webhooks.md

@@ -121,6 +121,8 @@ fimo webhooks list
 fimo webhooks get <webhook-id>
 fimo webhooks test <webhook-id> --wait
 fimo webhooks deliveries <webhook-id> --limit 20
+fimo webhooks deliveries <webhook-id> --cursor <next-cursor>
+fimo webhooks deliveries <webhook-id> --all-pages
 fimo webhooks delivery <webhook-id> <delivery-id>
 ```
 

package/assets/skills/fimo-code/references/frameworks/next.md

@@ -47,7 +47,10 @@ own tenant URL.
 ## Hosted preview config
 
 Wrap the existing Next config once so `next dev` accepts Fimo's hosted preview
-origins without exposing the active preview provider to the application:
+origins without exposing the active preview provider to the application. If
+the application does not set Next's `devIndicators`, the wrapper hides it in
+hosted Preview while local `next dev` keeps Next's default. Any explicit
+`devIndicators` setting is preserved:
 
 ```ts
 import type { NextConfig } from 'next';

package/assets/skills/fimo-code/references/frameworks/react-router.md

@@ -1,8 +1,9 @@
 # React Router framework mode
 
-This is the canonical Fimo + React Router framework-mode setup used by
-`fimo init`. You can also apply it to an existing React Router project: preserve
-its routes, rendering choices, providers, and SEO.
+This is the canonical Fimo React Router template and framework-mode setup used
+by `fimo init --framework react-router`. You can also apply it to an existing
+React Router project: preserve its routes, rendering choices, providers, and
+SEO.
 
 ## Install and build
 

package/assets/skills/fimo-studio/references/preview-and-responsive.md

@@ -2,7 +2,7 @@
 
 Click the **Preview** tab (the cursor/pointer icon) to see a live version of your site right inside the editor. You can also press **Alt+1** to jump to the preview tab.
 
-- Use the **route selector** dropdown at the top to navigate between different pages.
+- For Fimo-integrated sites, use the **route selector** dropdown at the top to navigate between different pages.
 - Click the **refresh** button to reload the preview.
 - Click the **external link** icon to open your site in a new browser tab for a full-screen view.
 
@@ -34,6 +34,9 @@ To go back to a full-width preview, toggle the responsive mode off.
 You may see different overlays depending on what is happening:
 
 - **"Working"** -- A loading overlay (heading "Working", subtext "Getting your preview in motion...") while the preview is being prepared.
+- **"Connecting to Fimo…"** -- The site is already visible while Studio waits for visual editing and route controls to connect. You can dismiss this status without interrupting the preview.
+- **"Recovering preview…"** -- The visible preview is reloading after a refresh or a recoverable development-server failure.
+- **"Editing unavailable"** -- The site remains visible, but its Fimo integration did not connect in time. Visual editing and the route selector stay unavailable; preview and refresh still work.
 - **Error overlay** -- Something went wrong. The overlay shows details about the issue, and the AI can often auto-fix it for you.
 - **"Some installed packages need approval"** -- Choose **Fix with Fimo** to send the complete repair context to the coding agent, or **Copy details** to handle it elsewhere. Review every named package, commit only trusted package-specific approvals, and retry Preview. Never replace the project policy with a blanket allow-all setting.
 - **First generation progress** -- When your project is being built for the first time, a progress overlay shows the current status.

package/assets/skills/fimo-studio/references/visual-editing.md

@@ -8,7 +8,15 @@ Once in edit mode, click on any element in the preview -- text, buttons, images,
 
 ### Editing Content
 
-For text elements, the side panel shows editable fields where you can change the text directly. This covers CMS-managed content, hardcoded text, and hardcoded images. Changes save automatically, and the preview updates as you type.
+For text elements, the side panel opens the selected field immediately with its current value. This covers CMS-managed content, hardcoded text, and hardcoded images. Changes save automatically, and the preview updates as you type.
+
+For CMS content, choose **All fields** to open the complete entry form. Studio keeps the content type's field order, scrolls to the field you selected, and focuses it in place. Loading appears only while Studio fetches this additional entry data or moves to another entry.
+
+### References and Components
+
+Selecting a field rendered from a referenced entry edits that entry. For example, selecting an author's name opens the Author entry, not the Post relation that links to it. The header shows the relation path. Select the owning entry in that path to return to its complete form with the relation field focused; use that relation field to open, replace, or clear the linked entry.
+
+Selecting a field inside a component focuses that nested field. Choose **All fields** to see it in the complete entry form without moving it out of schema order. The shared CMS form provides the existing add, duplicate, remove, and reorder controls for repeatable components and blocks.
 
 ### Editing Styles
 

package/dist/build/astro/config.js

@@ -1,6 +1,7 @@
 import { fileURLToPath } from 'node:url';
 import { getConfigPreviewRoutes } from '../../runtime/preview/routes.js';
 import { getConfigServer } from '../../runtime/shared/fimo-config.server.js';
+import previewHealthPlugin from '../vite/plugins/preview-health.js';
 import runtimeEnvPlugin from '../vite/plugins/runtime-env.js';
 function serializeForModule(value) {
     return (JSON.stringify(value) ?? 'undefined')
@@ -32,7 +33,7 @@ export function fimo(options = {}) {
                 // `as never` sidesteps a TS "excessive stack depth" on Astro's
                 // DeepPartial<AstroConfig> vs Vite's Plugin type; the shape is the
                 // documented `updateConfig({ vite: { plugins } })`.
-                updateConfig({ vite: { plugins: [runtimeEnvPlugin()] } });
+                updateConfig({ vite: { plugins: [runtimeEnvPlugin(), previewHealthPlugin()] } });
                 const fimoConfig = getConfigServer(fileURLToPath(config.root));
                 const routes = getConfigPreviewRoutes(fimoConfig);
                 injectScript('page', [

package/dist/build/vite/plugins/preview-health.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from 'vite';
+export declare const PREVIEW_HEALTH_PATH = "/__fimo/preview-health";
+export default function previewHealthPlugin(): Plugin;
+//# sourceMappingURL=preview-health.d.ts.map

package/dist/build/vite/plugins/preview-health.js

@@ -0,0 +1,40 @@
+export const PREVIEW_HEALTH_PATH = '/__fimo/preview-health';
+const OPTIMIZED_DEP_PATH = '/node_modules/.vite/deps/';
+export default function previewHealthPlugin() {
+    let failure = null;
+    return {
+        name: 'fimo:preview-health',
+        apply: 'serve',
+        configureServer(server) {
+            // FIMO-1589: the sandbox watcher needs a durable signal because Vite's
+            // one-shot HMR reload can fire before the hosted preview socket connects.
+            if (!process.env.FIMO_PREVIEW_ALLOWED_ORIGINS) {
+                return;
+            }
+            server.middlewares.use((req, res, next) => {
+                const url = new URL(req.url ?? '/', 'http://127.0.0.1');
+                if (url.pathname === PREVIEW_HEALTH_PATH) {
+                    res.statusCode = 200;
+                    res.setHeader('content-type', 'application/json');
+                    res.end(JSON.stringify({
+                        failureGeneration: failure?.generation ?? 0,
+                        lastFailure: failure,
+                    }));
+                    return;
+                }
+                if (url.pathname.includes(OPTIMIZED_DEP_PATH) && url.searchParams.has('v')) {
+                    res.once('finish', () => {
+                        if (res.statusCode >= 500) {
+                            failure = {
+                                generation: (failure?.generation ?? 0) + 1,
+                                status: res.statusCode,
+                                at: Date.now(),
+                            };
+                        }
+                    });
+                }
+                next();
+            });
+        },
+    };
+}

package/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-08-26T13:08:32.124Z",
+  "bundledAt": "2026-08-28T09:18:13.313Z",
   "cliVersion": "2.1.0",
   "external": [
     "oxc-parser",