fimo 2.1.0 → 2.2.0-staging.10

package/dist/runtime/shared/branch-identity.d.ts

@@ -0,0 +1,56 @@
+/**
+ * How a local checkout names and addresses a Fimo Branch — runtime-safe copy.
+ *
+ * TRAP: this looks like a duplicate of `@fimo/api-contracts` and it is, on
+ * purpose. `dist/runtime/` and `dist/build/` ship UNBUNDLED inside the `fimo`
+ * npm package and can only import published dependencies; `@fimo/api-contracts`
+ * is a private workspace package, so a runtime import of it breaks every user
+ * project (`ERR_MODULE_NOT_FOUND` from `vite.config.ts`). The CLI binary is
+ * bundled and may import contracts freely — the runtime may not.
+ *
+ * The two copies must agree byte-for-byte or a checkout computes a different
+ * tenant host than the API hands out. `branch-identity.test.ts` pins them
+ * together against a corpus; change one, and that test tells you to change the
+ * other.
+ */
+export declare const DEFAULT_BRANCH = "main";
+export declare const PROD_BRANCH_PREFIX = "release/";
+/** Mirror of `isValidBranch` in `@fimo/api-contracts`. */
+export declare function isValidBranch(branch: string): boolean;
+/**
+ * Mirror of `envResourceKey` in `@fimo/api-contracts`. Keeps that name on both
+ * sides: its OUTPUT is a live tenant hostname and R2 prefix, and the symbol
+ * rename is a later slice (branch-cutover ledger, F10).
+ */
+export declare function envResourceKey(branch: string): string;
+/** Mirror of `buildTenantApiUrl` in `@fimo/api-contracts`. */
+export declare function buildTenantApiUrl(projectId: string, branch: string, tenantApiBaseUrl: string): string;
+/**
+ * Content-API aliases a local checkout exposes — one per framework family
+ * that has a Fimo startup hook (Vite/React Router, Next, Astro, SvelteKit).
+ * Add a key when its framework's hook lands, not before: an alias no runtime
+ * reads is one more line to reason about when a site talks to the wrong Branch.
+ *
+ * These are process-env variable names in a CUSTOMER's app; they keep their
+ * `ENV` spelling (branch-cutover ledger, F3 "Preserve").
+ */
+export declare const LOCAL_CONTENT_API_ENV_KEYS: readonly ['FIMO_CONTENT_API_URL', 'VITE_API_URL', 'NEXT_PUBLIC_FIMO_API_URL', 'PUBLIC_FIMO_API_URL'];
+/**
+ * Branch selectors a runtime turns into the Branch request header.
+ *
+ * `FIMO_ENV` / `NEXT_PUBLIC_FIMO_ENV` are the variable names a customer's
+ * deployed build reads; renaming either breaks it (branch-cutover ledger,
+ * "Names that must not be mechanically renamed").
+ */
+export declare const LOCAL_ENV_SELECTOR_KEYS: readonly ['FIMO_ENV', 'NEXT_PUBLIC_FIMO_ENV'];
+/**
+ * Both halves move together. The tenant URL selects the Branch for content
+ * reads (each Branch has its own host); the selectors select it for every
+ * service that reads the Branch header. Setting one without the other points a
+ * checkout at two different Branches.
+ */
+export declare function buildLocalRuntimeEnv(options: {
+    readonly tenantApiUrl: string;
+    readonly branch: string;
+}): Record<string, string>;
+//# sourceMappingURL=branch-identity.d.ts.map

package/dist/runtime/shared/{env-identity.js → branch-identity.js}

@@ -1,5 +1,5 @@
 /**
- * How a local checkout names and addresses a Fimo env — runtime-safe copy.
+ * How a local checkout names and addresses a Fimo Branch — runtime-safe copy.
  *
  * TRAP: this looks like a duplicate of `@fimo/api-contracts` and it is, on
  * purpose. `dist/runtime/` and `dist/build/` ship UNBUNDLED inside the `fimo`
@@ -9,32 +9,32 @@
  * bundled and may import contracts freely — the runtime may not.
  *
  * The two copies must agree byte-for-byte or a checkout computes a different
- * tenant host than the API hands out. `env-identity.test.ts` pins them
+ * tenant host than the API hands out. `branch-identity.test.ts` pins them
  * together against a corpus; change one, and that test tells you to change the
  * other.
  */
-export const DEFAULT_ENV = 'main';
-export const PROD_ENV_PREFIX = 'release/';
-const ENV_ID_REGEX = /^[a-zA-Z0-9._/-]+$/;
-const MAX_ENV_LENGTH = 255;
-/** Mirror of `isValidEnv` in `@fimo/api-contracts`. */
-export function isValidEnv(env) {
-    if (typeof env !== 'string') {
+export const DEFAULT_BRANCH = 'main';
+export const PROD_BRANCH_PREFIX = 'release/';
+const BRANCH_ID_REGEX = /^[a-zA-Z0-9._/-]+$/;
+const MAX_BRANCH_LENGTH = 255;
+/** Mirror of `isValidBranch` in `@fimo/api-contracts`. */
+export function isValidBranch(branch) {
+    if (typeof branch !== 'string') {
         return false;
     }
-    if (env.length === 0 || env.length > MAX_ENV_LENGTH) {
+    if (branch.length === 0 || branch.length > MAX_BRANCH_LENGTH) {
         return false;
     }
-    if (env.startsWith('-') || env.startsWith('.')) {
+    if (branch.startsWith('-') || branch.startsWith('.')) {
         return false;
     }
-    if (env.includes('//') || env.includes('--')) {
+    if (branch.includes('//') || branch.includes('--')) {
         return false;
     }
-    if (env.split('/').some((segment) => segment === '..')) {
+    if (branch.split('/').some((segment) => segment === '..')) {
         return false;
     }
-    return ENV_ID_REGEX.test(env);
+    return BRANCH_ID_REGEX.test(branch);
 }
 function fnv1a8(s) {
     let h = 0x811c9dc5;
@@ -44,27 +44,34 @@ function fnv1a8(s) {
     }
     return (h >>> 0).toString(16).padStart(8, '0');
 }
-/** Mirror of `envResourceKey` in `@fimo/api-contracts`. */
-export function envResourceKey(env) {
-    const base = env
+/**
+ * Mirror of `envResourceKey` in `@fimo/api-contracts`. Keeps that name on both
+ * sides: its OUTPUT is a live tenant hostname and R2 prefix, and the symbol
+ * rename is a later slice (branch-cutover ledger, F10).
+ */
+export function envResourceKey(branch) {
+    const base = branch
         .toLowerCase()
         .replace(/[^a-z0-9]+/g, '-')
         .replace(/^-+|-+$/g, '')
         .slice(0, 15);
-    const hash = fnv1a8(env);
+    const hash = fnv1a8(branch);
     return base ? `${base}-${hash}` : hash;
 }
 /** Mirror of `buildTenantApiUrl` in `@fimo/api-contracts`. */
-export function buildTenantApiUrl(projectId, env, tenantApiBaseUrl) {
+export function buildTenantApiUrl(projectId, branch, tenantApiBaseUrl) {
     const url = new URL(tenantApiBaseUrl);
-    url.hostname = `${projectId}-${envResourceKey(env)}.${url.hostname}`;
+    url.hostname = `${projectId}-${envResourceKey(branch)}.${url.hostname}`;
     return url.toString().replace(/\/$/, '');
 }
 /**
  * Content-API aliases a local checkout exposes — one per framework family
  * that has a Fimo startup hook (Vite/React Router, Next, Astro, SvelteKit).
  * Add a key when its framework's hook lands, not before: an alias no runtime
- * reads is one more line to reason about when a site talks to the wrong env.
+ * reads is one more line to reason about when a site talks to the wrong Branch.
+ *
+ * These are process-env variable names in a CUSTOMER's app; they keep their
+ * `ENV` spelling (branch-cutover ledger, F3 "Preserve").
  */
 export const LOCAL_CONTENT_API_ENV_KEYS = [
     'FIMO_CONTENT_API_URL',
@@ -72,17 +79,23 @@ export const LOCAL_CONTENT_API_ENV_KEYS = [
     'NEXT_PUBLIC_FIMO_API_URL',
     'PUBLIC_FIMO_API_URL',
 ];
-/** Env selectors a runtime turns into the `X-Fimo-Env` request header. */
+/**
+ * Branch selectors a runtime turns into the Branch request header.
+ *
+ * `FIMO_ENV` / `NEXT_PUBLIC_FIMO_ENV` are the variable names a customer's
+ * deployed build reads; renaming either breaks it (branch-cutover ledger,
+ * "Names that must not be mechanically renamed").
+ */
 export const LOCAL_ENV_SELECTOR_KEYS = ['FIMO_ENV', 'NEXT_PUBLIC_FIMO_ENV'];
 /**
- * Both halves move together. The tenant URL selects the env for content reads
- * (each env has its own host); the selectors select it for every service that
- * reads `X-Fimo-Env`. Setting one without the other points a checkout at two
- * different envs.
+ * Both halves move together. The tenant URL selects the Branch for content
+ * reads (each Branch has its own host); the selectors select it for every
+ * service that reads the Branch header. Setting one without the other points a
+ * checkout at two different Branches.
  */
 export function buildLocalRuntimeEnv(options) {
     return {
         ...Object.fromEntries(LOCAL_CONTENT_API_ENV_KEYS.map((key) => [key, options.tenantApiUrl])),
-        ...Object.fromEntries(LOCAL_ENV_SELECTOR_KEYS.map((key) => [key, options.env])),
+        ...Object.fromEntries(LOCAL_ENV_SELECTOR_KEYS.map((key) => [key, options.branch])),
     };
 }

package/dist/runtime/shared/local-runtime-env.d.ts

@@ -38,9 +38,9 @@ export declare function resolveLocalRuntimeEnv(options: {
     readonly cwd: string;
 }): LocalRuntimeEnv | null;
 /**
- * The one case where "explicit wins" pins the app to the WRONG env: an
+ * The one case where "explicit wins" pins the app to the WRONG Branch: an
  * explicit tenant URL that Fimo itself minted for this project (old-CLI
- * `fimo clone` seeded the clone-time env's URL into `.env`) and that disagrees
+ * `fimo clone` seeded the clone-time Branch's URL into `.env`) and that disagrees
  * with the branch. A URL the user typed — `http://localhost:4000` — is never
  * reported; that is the override the design exists to protect.
  */

package/dist/runtime/shared/local-runtime-env.js

@@ -19,7 +19,7 @@ import { execFileSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 import { CURRENT_PROJECT_LAYOUT, LEGACY_PROJECT_LAYOUT } from '../project-layout.js';
-import { DEFAULT_ENV, LOCAL_CONTENT_API_ENV_KEYS, buildLocalRuntimeEnv, buildTenantApiUrl, isValidEnv, } from './env-identity.js';
+import { DEFAULT_BRANCH, LOCAL_CONTENT_API_ENV_KEYS, buildLocalRuntimeEnv, buildTenantApiUrl, isValidBranch, } from './branch-identity.js';
 /**
  * Derive the local runtime env, or `null` when this directory is not a linked
  * Fimo project (or the link predates `tenantApiBaseUrl` — nothing safe to
@@ -31,21 +31,23 @@ export function resolveLocalRuntimeEnv(options) {
     if (!root || !link) {
         return null;
     }
-    const branch = currentBranch(root);
-    const env = branch ?? DEFAULT_ENV;
-    const tenantApiUrl = buildTenantApiUrl(link.projectId, env, link.tenantApiBaseUrl);
+    const gitBranch = currentBranch(root);
+    const branch = gitBranch ?? DEFAULT_BRANCH;
+    const tenantApiUrl = buildTenantApiUrl(link.projectId, branch, link.tenantApiBaseUrl);
     return {
-        env,
+        // `env` stays the field name: `resolveLocalRuntimeEnv` is a published
+        // `fimo/config` export that framework adapters destructure.
+        env: branch,
         tenantApiUrl,
-        source: branch ? 'branch' : 'fallback',
-        values: buildLocalRuntimeEnv({ tenantApiUrl, env }),
+        source: gitBranch ? 'branch' : 'fallback',
+        values: buildLocalRuntimeEnv({ tenantApiUrl, branch }),
         link,
     };
 }
 /**
- * The one case where "explicit wins" pins the app to the WRONG env: an
+ * The one case where "explicit wins" pins the app to the WRONG Branch: an
  * explicit tenant URL that Fimo itself minted for this project (old-CLI
- * `fimo clone` seeded the clone-time env's URL into `.env`) and that disagrees
+ * `fimo clone` seeded the clone-time Branch's URL into `.env`) and that disagrees
  * with the branch. A URL the user typed — `http://localhost:4000` — is never
  * reported; that is the override the design exists to protect.
  */
@@ -128,7 +130,7 @@ function currentBranch(root) {
             stdio: ['ignore', 'pipe', 'ignore'],
             encoding: 'utf-8',
         }).trim();
-        return branch && branch !== 'HEAD' && isValidEnv(branch) ? branch : null;
+        return branch && branch !== 'HEAD' && isValidBranch(branch) ? branch : null;
     }
     catch {
         return null;

package/dist/runtime/templates.d.ts

@@ -30,7 +30,9 @@ export declare function getTemplatePath(framework?: TemplateFramework): string;
  */
 export declare function getLegacyTemplateDir(): string;
 export interface ReleaseMeta {
-    source: 'npm' | 'dev' | null;
+    source: 'npm' | 'url' | 'dev' | null;
+    /** Immutable artifact URL, baked into `source: 'url'` development tarballs. */
+    url?: string | null;
 }
 export interface DevReleaseVersion {
     devJsonPath: string | null;
@@ -40,7 +42,11 @@ export declare function readReleaseMeta(): ReleaseMeta;
 export declare function readCliSemver(): string | null;
 /**
  * Pure version: given a release manifest + CLI semver, return the value
- * to pin `fimo` to (or null for dev). Exported for unit tests.
+ * to pin `fimo` to (or null when nothing is known). Exported for unit tests.
+ *
+ * Throws rather than returning an unreproducible pin: a project that records a
+ * package-manager cache path (or a `fimo` its companions cannot follow) is
+ * broken on every other machine, and the error names the missing publish step.
  */
 export declare function computeFimoPin(meta: ReleaseMeta, semver: string | null, options?: {
     devPackageRoot?: string | null;

package/dist/runtime/templates.js

@@ -28,7 +28,7 @@ const PACKAGE_ROOT = path.resolve(MODULE_DIR, '..', '..');
 const RELEASE_FILE = path.join(PACKAGE_ROOT, 'release.json');
 const PACKAGE_JSON_FILE = path.join(PACKAGE_ROOT, 'package.json');
 export const TEMPLATE_FRAMEWORKS = ['react-router', 'vite', 'astro', 'nextjs', 'sveltekit'];
-export const DEFAULT_TEMPLATE = 'react-router';
+export const DEFAULT_TEMPLATE = 'nextjs';
 /**
  * Absolute path to the requested framework's template directory.
  *
@@ -69,8 +69,8 @@ export function readReleaseMeta() {
     try {
         const raw = fs.readFileSync(RELEASE_FILE, 'utf8');
         const parsed = JSON.parse(raw);
-        const source = parsed.source === 'npm' || parsed.source === 'dev' ? parsed.source : null;
-        return { source };
+        const source = parsed.source === 'npm' || parsed.source === 'dev' || parsed.source === 'url' ? parsed.source : null;
+        return { source, url: typeof parsed.url === 'string' && parsed.url.length > 0 ? parsed.url : null };
     }
     catch {
         return { source: null };
@@ -91,16 +91,34 @@ export function readCliSemver() {
 }
 /**
  * Pure version: given a release manifest + CLI semver, return the value
- * to pin `fimo` to (or null for dev). Exported for unit tests.
+ * to pin `fimo` to (or null when nothing is known). Exported for unit tests.
+ *
+ * Throws rather than returning an unreproducible pin: a project that records a
+ * package-manager cache path (or a `fimo` its companions cannot follow) is
+ * broken on every other machine, and the error names the missing publish step.
  */
 export function computeFimoPin(meta, semver, options = {}) {
     if (meta.source === 'npm') {
-        if (semver) {
-            return semver;
+        return semver;
+    }
+    // A checkout wins over a baked artifact URL: `publish-cli --id` keeps its
+    // release.json in the workspace so the next local run still iterates on
+    // source, not on the tarball it just uploaded.
+    const localPin = options.devPackageRoot ? `file:${options.devPackageRoot}` : null;
+    if (localPin && pinsWholeGroup(localPin)) {
+        return localPin;
+    }
+    if (meta.source === 'url') {
+        if (!meta.url) {
+            throw new Error('Refusing to create a project from a development CLI that was published without a public artifact URL. ' +
+                'Republish it remotely with `pnpm -F fimo publish-cli -- --id <task-name>` and install that artifact.');
         }
+        return meta.url;
     }
-    if ((meta.source === 'dev' || meta.source === null) && options.devPackageRoot) {
-        return `file:${options.devPackageRoot}`;
+    if (localPin) {
+        throw new Error(`Refusing to create a project pinned to ${localPin}: that path is not a Fimo checkout, so it is neither ` +
+            'reproducible on another machine nor able to pin the matching companion packages. Install `fimo` from npm, ' +
+            'or publish this CLI with `pnpm -F fimo publish-cli -- --id <task-name>` and install that artifact.');
     }
     return null;
 }
@@ -233,6 +251,14 @@ export function deriveFimoPackagePin(name, fimoPin) {
     }
     return fimoPin;
 }
+/**
+ * Whether every Fimo package can be pinned from this `fimo` pin. A pin that
+ * only the CLI can follow leaves the companions on the template's `latest`,
+ * which silently mixes channels inside one project (FIMO-2070).
+ */
+function pinsWholeGroup(fimoPin) {
+    return FIMO_PACKAGES.every((name) => deriveFimoPackagePin(name, fimoPin) !== null);
+}
 /**
  * Rewrite `fimo` and any companion packages present (in dependencies +
  * devDependencies) to the current pin. Only touches entries that look like a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "2.1.0",
+  "version": "2.2.0-staging.10",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "keywords": [
     "astro-component"
@@ -77,6 +77,10 @@
       "types": "./dist/runtime/astro/internal.d.ts",
       "import": "./dist/runtime/astro/internal.js"
     },
+    "./vite/preview-health": {
+      "types": "./dist/build/vite/plugins/preview-health.d.ts",
+      "import": "./dist/build/vite/plugins/preview-health.js"
+    },
     "./next": {
       "types": "./dist/build/next/moved.d.ts",
       "import": "./dist/build/next/moved.js"
@@ -184,12 +188,12 @@
   "devDependencies": {
     "@clack/core": "^1.2.0",
     "@clack/prompts": "^1.2.0",
-    "@fimo/agents-bundle": "2.1.0",
-    "@fimo/api-contracts": "2.1.0",
-    "@fimo/cli-kit": "2.1.0",
-    "@fimo/framework-detect": "2.1.0",
-    "@fimo/routes": "2.1.0",
-    "@fimo/tsconfig": "2.1.0",
+    "@fimo/agents-bundle": "2.2.0-staging.10",
+    "@fimo/api-contracts": "2.2.0-staging.10",
+    "@fimo/cli-kit": "2.2.0-staging.10",
+    "@fimo/framework-detect": "2.2.0-staging.10",
+    "@fimo/routes": "2.2.0-staging.10",
+    "@fimo/tsconfig": "2.2.0-staging.10",
     "@types/node": "22.18.6",
     "agent-install": "^0.0.5",
     "astro": "^7.1.6",
@@ -201,8 +205,8 @@
     "tsx": "4.22.4",
     "typescript": "7.0.2",
     "vite": "8.2.2",
-    "vitest": "4.1.10",
-    "wrangler": "4.124.0",
+    "vitest": "4.1.11",
+    "wrangler": "4.126.0",
     "yaml": "2.8.2"
   },
   "engines": {

package/release.json

@@ -1,5 +1,5 @@
 {
   "source": "npm",
-  "apiUrl": "https://api.fimo.ai",
-  "webUrl": "https://fimo.ai"
+  "apiUrl": "https://api.staging.fimo.team",
+  "webUrl": "https://staging.fimo.team"
 }

package/templates/astro/package.json

@@ -9,8 +9,8 @@
     "check": "astro sync && astro check"
   },
   "dependencies": {
-    "fimo": "2.1.0",
-    "fimo-astro": "2.1.0"
+    "fimo": "2.2.0-staging.10",
+    "fimo-astro": "2.2.0-staging.10"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/templates/nextjs/AGENTS.md

@@ -37,7 +37,7 @@ The scaffolded homepage is disposable. Replace it on the first real generation.
 - **Deploy is on-demand**, not a save step. Batch related edits into one deploy.
 - Use the selected package manager's committed build-script policy. pnpm projects pin `pnpm@10.26.0` and approve `esbuild` and `fimo` through `pnpm-workspace.yaml#allowBuilds`; Bun projects trust the same packages through `package.json#trustedDependencies`. Run a plain install with the selected manager so local installation matches Preview and production publishing. Review new dependencies before extending the policy; all three paths stop on unreviewed scripts.
 - Treat the user's language request as part of setup. The first explicitly requested locale is the primary locale; put it first and set it as `i18n.defaultLocale` in `.fimo/config.json`, with every requested locale in `i18n.locales`. If no language is requested, keep `en` and state that choice. That file is the only place to change: `src/locales.ts` reads it, so the served language and `<html lang>` follow. It does not create locale URLs; implement a URL strategy only when the product asks for one. Never introduce a default-locale environment variable.
-- Next's `app` tree is the router and stays authoritative: the starter is one ordinary root layout plus `/` as the homepage, and unknown paths get Next's native 404. When a product requires locale URLs, implement the framework-native strategy (`[locale]` segments, middleware, cookies, domains, or an i18n library), pass the resolved locale into Fimo server reads and `FimoProvider`, and load `fimo skills get fimo-code --ref frameworks/next/locales` first. Do not impose locale-prefixed URLs on a default-only project.
+- Next's `app` tree is the router and stays authoritative: the default shell is one ordinary root layout plus `/` as the homepage, and unknown paths get Next's native 404. When a product requires locale URLs, implement the framework-native strategy (`[locale]` segments, middleware, cookies, domains, or an i18n library), pass the resolved locale into Fimo server reads and `FimoProvider`, and load `fimo skills get fimo-code --ref frameworks/next/locales` first. Do not impose locale-prefixed URLs on a default-only project.
 - `FimoProvider` owns the optional Studio preview runtime. Do not add a preview bridge component, read Fimo preview environment variables, or inject Fimo scripts in application code.
 - Keep `.fimo/config.json#routes` as Studio metadata, not as the Next.js router. Describe only URLs the application actually serves; add a `:locale` segment to a route's metadata only after the application implements that locale routing. There, `params.locale.optional: true` means omit the configured default locale from the URL; use `optional: false` only when every locale, including the default, must be prefixed.
 - The application owns routes, locale resolution, links, HTML language/direction, and SEO. Fimo connects to those decisions.

package/templates/nextjs/package.json

@@ -12,10 +12,10 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.1.0",
-    "fimo-next": "2.1.0",
-    "fimo-react": "2.1.0",
-    "next": "^16.3.0",
+    "fimo": "2.2.0-staging.10",
+    "fimo-next": "2.2.0-staging.10",
+    "fimo-react": "2.2.0-staging.10",
+    "next": "^16.3.3",
     "react": "^19.2.7",
     "react-dom": "^19.2.7"
   },

package/templates/react-router/.fimo/config.json

@@ -2,8 +2,7 @@
   "runtime": { "framework": "react-router" },
   "seo": {
     "title": "Welcome to your Fimo website",
-    "description": "A default homepage starter for Fimo projects.",
-    "siteName": "Fimo Starter Site",
+    "description": "A default homepage for Fimo projects.",
     "url": "https://fimo.ai/",
     "image": "https://fimo.ai/socials/og_cover.png",
     "favicon": "https://fimo.ai/favicon-orange.svg",

package/templates/react-router/AGENTS.md

@@ -47,6 +47,6 @@ breaks that. Load `fimo-code` for the exact primitives, but the rule is:
 - Do not add a second deploy tool (Vercel, Netlify, etc.).
 - **Never edit `.fimo/project.json`** — it links this folder to the remote project.
 - **Keep `.fimo/config.json#runtime` true to the code** — framework, `dev`/`build`/`install` commands, output directory. Update it when you rename a package script, move the build output, or change framework; the reference is `fimo skills get fimo-code --ref frameworks/hosting`.
-- The scaffolded homepage is disposable starter content. Replace it on the first real generation.
+- The scaffolded homepage is disposable template content. Replace it on the first real generation.
 - **Secrets live in the Fimo dashboard**, not in a committed `.env`.
 - When scripting, pass flags to `fimo` commands (`fimo deploy -m "…"`, `fimo delete -y`) — bare interactive forms hang in non-TTY shells.

package/templates/react-router/package.json

@@ -21,10 +21,10 @@
     "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
     "embla-carousel-react": "^8.6.0",
-    "fimo": "2.1.0",
-    "fimo-react": "2.1.0",
-    "fimo-react-router": "2.1.0",
-    "fimo-vite": "2.1.0",
+    "fimo": "2.2.0-staging.10",
+    "fimo-react": "2.2.0-staging.10",
+    "fimo-react-router": "2.2.0-staging.10",
+    "fimo-vite": "2.2.0-staging.10",
     "input-otp": "^1.4.2",
     "isbot": "^5",
     "lucide-react": "^0.577.0",

package/templates/sveltekit/package.json

@@ -11,8 +11,8 @@
     "prepare": "svelte-kit sync"
   },
   "dependencies": {
-    "fimo": "2.1.0",
-    "fimo-sveltekit": "2.1.0"
+    "fimo": "2.2.0-staging.10",
+    "fimo-sveltekit": "2.2.0-staging.10"
   },
   "devDependencies": {
     "@sveltejs/kit": "^2.70.2",

package/templates/vite/package.json

@@ -11,10 +11,10 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.1.0",
-    "fimo-react": "2.1.0",
-    "fimo-react-router": "2.1.0",
-    "fimo-vite": "2.1.0",
+    "fimo": "2.2.0-staging.10",
+    "fimo-react": "2.2.0-staging.10",
+    "fimo-react-router": "2.2.0-staging.10",
+    "fimo-vite": "2.2.0-staging.10",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-router": "^8.3.0"

package/assets/starters/fimo-site/manifest.json

@@ -1,64 +0,0 @@
-{
-  "name": "fimo-site",
-  "version": 1,
-  "description": "A content-led site with a homepage, contact form, labels, and manual review agents.",
-  "singletons": [
-    {
-      "type": "HomePage",
-      "data": {
-        "eyebrow": "Field notes",
-        "title": "Your website, ready to edit.",
-        "intro": {
-          "type": "doc",
-          "content": [
-            {
-              "type": "paragraph",
-              "content": [
-                {
-                  "type": "text",
-                  "text": "This starter is real website content. Edit the copy in Studio, change the code with your favorite agent, and keep both surfaces in sync."
-                }
-              ]
-            }
-          ]
-        },
-        "primaryCtaLabel": "Read the field notes",
-        "primaryCtaHref": "#stories",
-        "featured": [
-          {
-            "label": "Start here",
-            "title": "A calmer content workflow",
-            "summary": "Keep content, code, previews, and the team in one editable project.",
-            "href": "#stories"
-          },
-          {
-            "label": "For agents",
-            "title": "Build once, keep iterating",
-            "summary": "Give your coding agent a real CMS surface to work with after the first deploy.",
-            "href": "#stories"
-          },
-          {
-            "label": "For teams",
-            "title": "Make every edit reviewable",
-            "summary": "Let teammates shape the site without asking them to open a code editor.",
-            "href": "#stories"
-          }
-        ],
-        "contactHeading": "Make something useful",
-        "contactIntro": "Tell us what you are building and we will help you find the shortest path from first draft to a site your team can own."
-      }
-    }
-  ],
-  "labels": [
-    { "key": "nav.stories", "value": "Field notes", "locale": "en" },
-    { "key": "nav.contact", "value": "Start a conversation", "locale": "en" },
-    { "key": "hero.scroll", "value": "Explore the starter", "locale": "en" },
-    { "key": "contact.name", "value": "Your name", "locale": "en" },
-    { "key": "contact.email", "value": "Email address", "locale": "en" },
-    { "key": "contact.message", "value": "What are you building?", "locale": "en" },
-    { "key": "contact.submit", "value": "Send a note", "locale": "en" },
-    { "key": "contact.sent", "value": "Thanks. Your note is on its way.", "locale": "en" },
-    { "key": "contact.failed", "value": "That did not send. Please try again.", "locale": "en" }
-  ],
-  "forms": ["contact"]
-}

package/assets/starters/fimo-site/template/.fimo/agents/content-guide/GOAL.md

@@ -1,8 +0,0 @@
-# Content guide
-
-Inspect the site's content model and homepage copy. Suggest a small editorial
-backlog that makes the site more useful to its intended audience.
-
-Return three suggestions, each with the content type or field it touches and
-why it matters. Use the existing content as evidence. Do not write files,
-change entries, or create labels.

package/assets/starters/fimo-site/template/.fimo/agents/content-guide/capabilities.yaml

@@ -1 +0,0 @@
-- cms:read

package/assets/starters/fimo-site/template/.fimo/agents/content-guide/config.yaml

@@ -1,9 +0,0 @@
-# Keep starter agents manual-only. Adding a schedule or webhook and pushing to
-# main registers an automation for the project.
-version: 1
-description: 'Suggest useful editorial improvements from the existing CMS content.'
-data_sources:
-  - main
-
-triggers:
-  - type: manual

package/assets/starters/fimo-site/template/.fimo/agents/site-review/GOAL.md

@@ -1,14 +0,0 @@
-# Site review
-
-Review the starter project as a teammate would before the first publish.
-
-Read the declared routes, the CMS content, the labels, and the public site.
-Return a short report with:
-
-- one thing that already feels clear;
-- the three highest-value improvements;
-- any missing content or broken route you can prove;
-- one next action that a human or coding agent can review.
-
-This is a read-only review. Do not edit files, change CMS content, create
-branches, or publish anything.

package/assets/starters/fimo-site/template/.fimo/agents/site-review/capabilities.yaml

@@ -1,3 +0,0 @@
-- cms:read
-- i18n:read
-- net:fetch

package/assets/starters/fimo-site/template/.fimo/agents/site-review/config.yaml

@@ -1,9 +0,0 @@
-# Keep starter agents manual-only. Adding a schedule or webhook and pushing to
-# main registers an automation for the project.
-version: 1
-description: 'Review the starter site and return a concise, read-only launch report.'
-data_sources:
-  - main
-
-triggers:
-  - type: manual