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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/assets/skills/fimo-cli/SKILL.md +4 -2
  2. package/assets/skills/fimo-cli/references/agents.md +3 -3
  3. package/assets/skills/fimo-cli/references/branches.md +9 -8
  4. package/assets/skills/fimo-cli/references/credits.md +12 -19
  5. package/assets/skills/fimo-cli/references/deploy.md +6 -6
  6. package/assets/skills/fimo-cli/references/history.md +2 -2
  7. package/assets/skills/fimo-cli/references/inbox.md +86 -0
  8. package/assets/skills/fimo-cli/references/init.md +7 -6
  9. package/assets/skills/fimo-cli/references/invite.md +11 -9
  10. package/assets/skills/fimo-cli/references/labels.md +3 -11
  11. package/assets/skills/fimo-cli/references/locales.md +5 -3
  12. package/assets/skills/fimo-cli/references/preview.md +1 -2
  13. package/assets/skills/fimo-cli/references/projects.md +8 -8
  14. package/assets/skills/fimo-cli/references/schedules.md +2 -2
  15. package/assets/skills/fimo-cli/references/webhooks.md +4 -4
  16. package/assets/skills/fimo-code/references/frameworks/astro.md +1 -1
  17. package/assets/skills/fimo-code/references/frameworks/next/locales.md +2 -2
  18. package/assets/skills/fimo-code/references/locales.md +4 -2
  19. package/assets/skills/fimo-studio/references/ai-chat.md +1 -2
  20. package/assets/skills/fimo-studio/references/billing-and-credits.md +14 -7
  21. package/assets/skills/fimo-studio/references/webhooks.md +1 -1
  22. package/dist/cli/bundle.json +1 -1
  23. package/dist/cli/index.js +194 -178
  24. package/dist/runtime/shared/local-runtime-env.d.ts +2 -2
  25. package/dist/runtime/shared/local-runtime-env.js +14 -9
  26. package/package.json +9 -8
  27. package/templates/astro/AGENTS.md +1 -1
  28. package/templates/astro/package.json +2 -2
  29. package/templates/nextjs/AGENTS.md +1 -1
  30. package/templates/nextjs/package.json +3 -3
  31. package/templates/react-router/AGENTS.md +2 -2
  32. package/templates/react-router/package.json +4 -4
  33. package/templates/sveltekit/AGENTS.md +1 -1
  34. package/templates/sveltekit/package.json +2 -2
  35. package/templates/vite/AGENTS.md +5 -1
  36. package/templates/vite/package.json +4 -4
@@ -35,7 +35,7 @@ When labels are not needed at that boundary, use `<FimoProvider locale={locale}>
35
35
 
36
36
  ## New-project boundary
37
37
 
38
- Choose the primary locale from the user's request before building pages. Put the first explicitly requested locale in `.fimo/config.json#i18n.defaultLocale` and keep all requested locales in `i18n.locales`. That is content and provider configuration: `src/locales.ts` reads the file, so the default locale passed to `FimoProvider` and the `<html lang>` follow it. It does not create locale URLs. If the user gives no locale signal, keep `en` and state that choice. Never add `NEXT_PUBLIC_FIMO_DEFAULT_LOCALE` or `FIMO_DEFAULT_LOCALE`; the runtime ignores them by design.
38
+ Choose the primary locale from the user's request before building pages. Configure the supported locales and default through the `fimo-cli` locale workflow. `src/locales.ts` reads the synchronized config, so the default locale passed to `FimoProvider` and the `<html lang>` follow it. It does not create locale URLs. If the user gives no locale signal, keep `en` and state that choice. Never add `NEXT_PUBLIC_FIMO_DEFAULT_LOCALE` or `FIMO_DEFAULT_LOCALE`; the runtime ignores them by design.
39
39
 
40
40
  The starter is default-only: one ordinary root layout renders `<html lang={defaultLocale}>` and `FimoProvider`, `/` is the homepage, and unknown paths get Next's native 404. Implement a locale routing strategy only when the product asks for one — prefixed `[locale]` segments, middleware, cookies, domains, or an i18n library are all Next decisions — then resolve the locale in that strategy and pass it into Fimo server reads and `FimoProvider`. Do not install a top-level `[locale]` route or an optional catch-all speculatively: it captures `/favicon.ico` and every unknown top-level path, and Fimo never requires it.
41
41
 
@@ -45,7 +45,7 @@ When the app implements a localized URL shape, describe it in `.fimo/config.json
45
45
 
46
46
  With `next-i18next`, keep its routing and translation provider for the strings it owns. Pass the same resolved locale to Fimo; do not replace the library or duplicate its route structure.
47
47
 
48
- Before creating non-default Fimo labels or content variants, confirm that those locales are enabled for the linked Fimo project. Load `fimo-cli` with its `locales` reference and run `fimo locales add <locale> --yes --json`; `.fimo/config.json` documents the application's locale policy, but `fimo validate` does not add project locales.
48
+ Before creating non-default Fimo labels or content variants, confirm that those locales are enabled for the linked Fimo project. Load `fimo-cli` with its `locales` reference and run `fimo locales add <locale> --yes --json`; `fimo validate` does not add project locales.
49
49
 
50
50
  ## Ownership boundary
51
51
 
@@ -13,11 +13,13 @@ The application owns locale resolution and routing. Fimo consumes the resolved l
13
13
  }
14
14
  ```
15
15
 
16
- For new projects, derive the primary locale from the request; when several are explicit, the first one named is the default. Update `i18n.defaultLocale`, `i18n.locales`, the document language default, and any framework-native locale route boundary or matcher the application implements. If the user gives no locale signal, retain the starter default and state that choice.
16
+ For a linked project, load `fimo-cli` with its `locales` reference and use the typed locale commands to change the supported locales or default. That reference owns the synchronization and recovery contract.
17
+
18
+ For new projects, derive the primary locale from the request; when several are explicit, the first one named is the default. Configure that locale set through the lifecycle commands, then update the document language default and any framework-native locale route boundary or matcher the application implements. If the user gives no locale signal, retain the starter default and state that choice.
17
19
 
18
20
  Keep one locale unless the product asks for multilingual output. Keep it locale-ready without forcing `/en`, a language switcher, global path-prefix routing, or localized schemas. Locale tags should be structurally valid, such as `en`, `pt-BR`, or `zh-Hans`.
19
21
 
20
- For an already linked project, enable each locale in Fimo before writing non-default label or content variants. Load `fimo-cli` with its `locales` reference and run `fimo locales add <locale> --yes --json`; local config and `fimo validate` do not provision project locales. Do not change the application's route strategy to work around a missing locale.
22
+ Enable each locale before writing non-default label or content variants. Run `fimo locales add <locale> --yes --json`; `fimo validate` does not provision project locales. Do not change the application's route strategy to work around a missing locale.
21
23
 
22
24
  ## Application responsibilities
23
25
 
@@ -13,7 +13,7 @@ On desktop, the AI chat opens docked on the left by default. You can make it flo
13
13
 
14
14
  The AI can place choices, cards, tables, images, and contextual actions directly in its reply. Optional suggestions do not interrupt the conversation.
15
15
 
16
- When the AI needs an answer before it can continue, it shows a form in the chat and waits for your response. Complete the form for a structured answer, or reply normally in the chat to answer in your own words.
16
+ When the AI needs an answer before it can continue, it pins a form directly above the message box and waits for your response. The form stays there while you scroll the conversation; the message that asked shows **Waiting for your answer...** in its place in the history. Select **Minimize** to fold the form to one line without losing your answers, then select that line to reopen it. **Submit** sends only the completed form and leaves anything typed in the message box unsent. Sending from the message box includes any selections already made in the form with your message; with no selections, it is an ordinary reply. A form with many steps scrolls inside its own area, and its **Next** / **Submit** buttons stay in view.
17
17
 
18
18
  ## Attaching Context
19
19
 
@@ -60,7 +60,6 @@ The AI runs on credits. You can see your balance by clicking the **coin icon** n
60
60
 
61
61
  Clicking it opens a breakdown showing:
62
62
 
63
- - **Daily free credits** that reset each day.
64
63
  - **Monthly credits** included with your plan.
65
64
  - **Purchased credits** you bought separately.
66
65
  - **Earned credits** from referrals or promotions.
@@ -1,13 +1,12 @@
1
1
  ## Credit Types
2
2
 
3
- Fimo uses credits for AI-powered features. There are four kinds:
3
+ Fimo uses credits for AI-powered features. There are three kinds:
4
4
 
5
- - **Daily free credits** -- a small pool that resets every day. Available on all plans, including free.
6
- - **Monthly credits** -- a larger pool that comes with your plan. Resets at the start of each billing cycle.
5
+ - **Monthly credits** -- the pool that comes with your plan. Resets at the start of each billing cycle.
7
6
  - **Purchased credits** -- bought with real money. These do not expire and stay in your account until you use them.
8
7
  - **Awarded credits** -- gained through referrals or promotions. These also do not expire.
9
8
 
10
- Credits are consumed in order: daily free first, then monthly, then awarded, then purchased.
9
+ Credits are consumed in order: monthly first, then awarded, then purchased.
11
10
 
12
11
  ## Checking Your Balance
13
12
 
@@ -16,11 +15,11 @@ Look for the **coin icon with a number** near the chat send button. That number
16
15
  - Click it to open a detailed breakdown showing how many credits you have in each category.
17
16
  - When your balance is low, opening that breakdown shows an alert-triangle warning ("No credits left" or "_N_ credits left") at the bottom.
18
17
 
19
- From a linked project directory, `fimo credits` shows the same organization balance in the CLI. Its "Available now" total already includes the visible buckets; the daily allowance section is not additional balance.
18
+ From a linked project directory, `fimo credits` shows the same organization balance in the CLI. Its "Available now" total already includes the visible buckets.
20
19
 
21
20
  ## Buying More Credits
22
21
 
23
- Buying credits is available on the **Premium** plan, since it charges the payment method already on file.
22
+ Buying credits is available on paid plans, since it charges the payment method already on file.
24
23
 
25
24
  1. Click the credit display near the chat input.
26
25
  2. Click **Buy credits**.
@@ -30,7 +29,7 @@ Buying credits is available on the **Premium** plan, since it charges the paymen
30
29
 
31
30
  ## Refilling Credits Automatically
32
31
 
33
- Organization billing admins on Premium can configure auto-refill from **Settings > Billing**:
32
+ Organization billing admins on a paid plan can configure auto-refill from **Settings > Billing**:
34
33
 
35
34
  1. Choose the balance threshold that should trigger a refill.
36
35
  2. Choose the dollar amount to purchase when the balance crosses that threshold.
@@ -52,6 +51,14 @@ From there:
52
51
  3. Pick a plan and complete checkout.
53
52
  4. Your new monthly credit pool is available right away.
54
53
 
54
+ ## Changing or leaving a paid plan
55
+
56
+ - Free to Pay as you go or Pro, and Pay as you go to Pro, use checkout and take effect after payment succeeds.
57
+ - Pro to Pay as you go or Free takes effect at the end of the current billing period. Billing shows the destination and effective date until then.
58
+ - Choosing the current plan again before that date cancels the scheduled change.
59
+ - Pay as you go requires an active payment method. Removing its only valid card returns the organization to Free immediately.
60
+ - A failed Pro renewal follows the payment-recovery flow. It never silently changes the organization to Pay as you go.
61
+
55
62
  ## Legacy plan transitions
56
63
 
57
64
  Some organizations that already have Premium may see a **Plan transition**
@@ -17,7 +17,7 @@ Only project members with Full Access can see Webhooks in Settings or manage its
17
17
 
18
18
  The event groups are Entries, Forms, Publish, Agents, Analytics, Media, Domains, Labels, Locales, and Environments. Webhooks belong to the project, with up to 20 configurations. Choose the Main Branch, All Branches, Production, Preview, or one custom Environment. Main Branch is the default.
19
19
 
20
- Entry webhooks show **Combine rapid changes**. The default waits 5 seconds after direct editing stops and sends one delivery with the combined changes. Immediate, 30-second, and 1-minute windows are also available. Bulk edits and environment merges already produce batches and send immediately.
20
+ Entry webhooks send one delivery per committed write. A bulk edit or environment merge may contain a bounded batch, and wider changes split into separately delivered batches.
21
21
 
22
22
  ## Configure the request
23
23
 
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "bundled": true,
3
3
  "bundler": "esbuild",
4
- "bundledAt": "2026-08-28T21:37:20.437Z",
4
+ "bundledAt": "2026-09-01T08:14:56.822Z",
5
5
  "cliVersion": "2.1.0",
6
6
  "external": [
7
7
  "oxc-parser",