fimo 2.2.0-staging.13 → 2.2.0-staging.14

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

@@ -31,8 +31,8 @@ export interface LocalProjectLink {
 }
 /**
  * Derive the local runtime env, or `null` when this directory is not a linked
- * Fimo project (or the link predates `tenantApiBaseUrl` — nothing safe to
- * derive, so nothing is).
+ * Fimo project, Git cannot name the current Branch, or the link predates
+ * `tenantApiBaseUrl`.
  */
 export declare function resolveLocalRuntimeEnv(options: {
     readonly cwd: string;

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

@@ -19,11 +19,11 @@ 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_BRANCH, LOCAL_CONTENT_API_ENV_KEYS, buildLocalRuntimeEnv, buildTenantApiUrl, isValidBranch, } from './branch-identity.js';
+import { 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
- * derive, so nothing is).
+ * Fimo project, Git cannot name the current Branch, or the link predates
+ * `tenantApiBaseUrl`.
  */
 export function resolveLocalRuntimeEnv(options) {
     const root = findProjectRoot(options.cwd);
@@ -31,15 +31,17 @@ export function resolveLocalRuntimeEnv(options) {
     if (!root || !link) {
         return null;
     }
-    const gitBranch = currentBranch(root);
-    const branch = gitBranch ?? DEFAULT_BRANCH;
+    const branch = currentBranch(root);
+    if (!branch) {
+        return null;
+    }
     const tenantApiUrl = buildTenantApiUrl(link.projectId, branch, link.tenantApiBaseUrl);
     return {
         // `env` stays the field name: `resolveLocalRuntimeEnv` is a published
         // `fimo/config` export that framework adapters destructure.
         env: branch,
         tenantApiUrl,
-        source: gitBranch ? 'branch' : 'fallback',
+        source: 'branch',
         values: buildLocalRuntimeEnv({ tenantApiUrl, branch }),
         link,
     };
@@ -125,12 +127,12 @@ export function readLocalEnvFiles(cwd) {
  */
 function currentBranch(root) {
     try {
-        const branch = execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+        const branch = execFileSync('git', ['symbolic-ref', '--short', '-q', 'HEAD'], {
             cwd: root,
             stdio: ['ignore', 'pipe', 'ignore'],
             encoding: 'utf-8',
         }).trim();
-        return branch && branch !== 'HEAD' && isValidBranch(branch) ? branch : null;
+        return branch && isValidBranch(branch) ? branch : null;
     }
     catch {
         return null;
@@ -162,7 +164,10 @@ function readProjectLink(root) {
                 parsed.projectId.length > 0 &&
                 typeof parsed.tenantApiBaseUrl === 'string' &&
                 parsed.tenantApiBaseUrl.length > 0) {
-                return { projectId: parsed.projectId, tenantApiBaseUrl: parsed.tenantApiBaseUrl };
+                return {
+                    projectId: parsed.projectId,
+                    tenantApiBaseUrl: parsed.tenantApiBaseUrl,
+                };
             }
         }
         catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "2.2.0-staging.13",
+  "version": "2.2.0-staging.14",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "keywords": [
     "astro-component"
@@ -184,17 +184,18 @@
     "change-case": "^5.4.4",
     "eta": "^3.5.0",
     "oxc-parser": "^0.118.0",
-    "zod": "4.4.3"
+    "zod": "4.5.2"
   },
   "devDependencies": {
     "@clack/core": "^1.2.0",
     "@clack/prompts": "^1.2.0",
-    "@fimo/agents-bundle": "2.2.0-staging.13",
-    "@fimo/api-contracts": "2.2.0-staging.13",
-    "@fimo/cli-kit": "2.2.0-staging.13",
-    "@fimo/framework-detect": "2.2.0-staging.13",
-    "@fimo/routes": "2.2.0-staging.13",
-    "@fimo/tsconfig": "2.2.0-staging.13",
+    "@fimo/agents-bundle": "2.2.0-staging.14",
+    "@fimo/api-contracts": "2.2.0-staging.14",
+    "@fimo/cli-kit": "2.2.0-staging.14",
+    "@fimo/framework-detect": "2.2.0-staging.14",
+    "@fimo/routes": "2.2.0-staging.14",
+    "@fimo/sdk": "2.2.0-staging.14",
+    "@fimo/tsconfig": "2.2.0-staging.14",
     "@types/node": "22.18.6",
     "agent-install": "^0.0.5",
     "astro": "^7.1.6",

package/templates/astro/AGENTS.md

@@ -28,7 +28,7 @@ a code-only task, or use `npx fimo@latest` for project-local code generation and
 
 - **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`. If no language is requested, keep `en` and state that choice. Astro reads this configuration directly, keeps the default locale unprefixed, and prefixes the others.
+- Treat the user's language request as part of setup. The first explicitly requested locale is the primary locale. Load `fimo skills get fimo-cli --ref locales` and use `fimo locales` to configure the exact locale set and default. Never edit `i18n.defaultLocale` or `i18n.locales` directly. If no language is requested, keep `en` and state that choice. Astro reads the synchronized config, keeps the default locale unprefixed, and prefixes the others.
 - Preserve both the unprefixed default pages and the `[locale]` page tree. Astro has no optional single-segment file route, so the paired native pages keep one-locale URLs clean and allow another locale without changing the route shape. Use `Astro.currentLocale` for Fimo content reads, `getLabels`, and document language.
 - Keep `.fimo/config.json#routes` as Studio metadata aligned with Astro's page files. It does not configure Astro routing.
 - Astro owns routes, locale resolution, links, HTML language/direction, and SEO. Fimo connects to those decisions.

package/templates/astro/package.json

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

package/templates/nextjs/AGENTS.md

@@ -36,7 +36,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.
+- Treat the user's language request as part of setup. The first explicitly requested locale is the primary locale. Load `fimo skills get fimo-cli --ref locales` and use `fimo locales` to configure the exact locale set and default. Never edit `i18n.defaultLocale` or `i18n.locales` directly. If no language is requested, keep `en` and state that choice. `src/locales.ts` reads the synchronized config, so the served language and `<html lang>` follow. Locale configuration 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 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.

package/templates/nextjs/package.json

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

package/templates/react-router/AGENTS.md

@@ -41,8 +41,8 @@ breaks that. Load `fimo-code` for the exact primitives, but the rule is:
 
 - **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`. If no language is requested, keep `en` and state that choice.
-- Preserve the application-owned `:locale?` route boundary in `src/routes.ts` and pass its route parameter to `FimoProviders` in `LocaleLayout.tsx`. The missing parameter uses the configured default, so a one-locale site stays at `/`. Add locales in `.fimo/config.json` without rebuilding the route tree; use `:locale` without `?` only when every locale must be prefixed.
+- Treat the user's language request as part of setup. The first explicitly requested locale is the primary locale. Load `fimo skills get fimo-cli --ref locales` and use `fimo locales` to configure the exact locale set and default. Never edit `i18n.defaultLocale` or `i18n.locales` directly. If no language is requested, keep `en` and state that choice.
+- Preserve the application-owned `:locale?` route boundary in `src/routes.ts` and pass its route parameter to `FimoProviders` in `LocaleLayout.tsx`. The missing parameter uses the configured default, so a one-locale site stays at `/`. Configured locales use the same route tree; use `:locale` without `?` only when every locale must be prefixed.
 - Keep `.fimo/config.json#routes` aligned as Studio metadata, not as the React Router source of truth. Do not add a global locale-routing strategy, a Fimo route helper, or a Fimo-owned route tree.
 - Do not add a second deploy tool (Vercel, Netlify, etc.).
 - **Never edit `.fimo/project.json`** — it links this folder to the remote project.

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.2.0-staging.13",
-    "fimo-react": "2.2.0-staging.13",
-    "fimo-react-router": "2.2.0-staging.13",
-    "fimo-vite": "2.2.0-staging.13",
+    "fimo": "2.2.0-staging.14",
+    "fimo-react": "2.2.0-staging.14",
+    "fimo-react-router": "2.2.0-staging.14",
+    "fimo-vite": "2.2.0-staging.14",
     "input-otp": "^1.4.2",
     "isbot": "^5",
     "lucide-react": "^0.577.0",

package/templates/sveltekit/AGENTS.md

@@ -28,7 +28,7 @@ a code-only task, or use `npx fimo@latest` for project-local code generation and
 
 - **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`. If no language is requested, keep `en` and state that choice. `src/locales.ts` derives the default and prefixed locale set from that config.
+- Treat the user's language request as part of setup. The first explicitly requested locale is the primary locale. Load `fimo skills get fimo-cli --ref locales` and use `fimo locales` to configure the exact locale set and default. Never edit `i18n.defaultLocale` or `i18n.locales` directly. If no language is requested, keep `en` and state that choice. `src/locales.ts` derives the default and prefixed locale set from the synchronized config.
 - Preserve the native `[[locale=locale]]` route boundary. The optional parameter keeps the default locale at `/`; the matcher prevents ordinary top-level routes from being mistaken for locales. The root server layout passes the tracked `event.params` through `resolveLocale`, then sends that locale to `getLabels` and `FimoProvider`. Remove the extra brackets only when every locale must be prefixed.
 - Keep the document language request-aware: `src/hooks.server.ts` renders the initial `<html lang>`, and the root layout updates it after client navigation.
 - Keep `.fimo/config.json#routes` as Studio metadata aligned with SvelteKit's route files. It does not configure SvelteKit routing.

package/templates/sveltekit/package.json

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

package/templates/vite/AGENTS.md

@@ -28,8 +28,12 @@ fimo`, or `bunx --no-install fimo` when the project uses that package manager.
 - Use Fimo schemas and generated clients for content, labels for editable strings, Fimo primitives for media, and
   generated form helpers for submissions. Load `fimo-code` for their current APIs.
 - The scaffolded homepage is disposable. Replace it when building the requested site.
+- Treat the user's language request as part of setup. The first explicitly requested locale is the primary locale.
+  Load `fimo skills get fimo-cli --ref locales` and use `fimo locales` to configure the exact locale set and default.
+  Never edit `i18n.defaultLocale` or `i18n.locales` directly. If no language is requested, keep `en` and state that
+  choice.
 - Preserve `BrowserRouter`. Keep the application-owned optional `:locale?` route and pass its parameter to
-  `FimoProviders`. English is the default; adding configured locales must not require rebuilding the route tree.
+  `FimoProviders`. Configured locales use the same route tree.
 - Keep `.fimo/config.json#routes` aligned as Studio metadata. React Router remains the source of truth.
 - Keep the catch-all rewrite to `/index.html` so direct visits reach the browser router.
 - Keep `fimo-react-router/vite` composed with the React Vite plugin and `FimoProviders` inside the router context.

package/templates/vite/package.json

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