fimo 2.11.0-staging.5 → 2.11.0-staging.6
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.
- package/assets/skills/fimo-cli/SKILL.studio.md +1 -1
- package/assets/skills/fimo-cli/references/domains.md +1 -1
- package/assets/skills/fimo-cli/references/preview.md +7 -0
- package/assets/skills/fimo-code/references/content/richtext.md +2 -0
- package/assets/skills/fimo-code/references/frameworks/seo-head.md +3 -2
- package/assets/skills/fimo-studio/references/ai-chat.md +2 -1
- package/dist/cli/bundle.json +1 -1
- package/dist/cli/index.js +13 -12
- package/dist/runtime/seo/resolver.d.ts +4 -3
- package/dist/runtime/seo/resolver.js +7 -3
- package/package.json +8 -8
- package/templates/astro/package.json +3 -3
- package/templates/nextjs/package.json +4 -4
- package/templates/react-router/package.json +5 -5
- package/templates/sveltekit/package.json +3 -3
- package/templates/vite/package.json +5 -5
|
@@ -29,7 +29,7 @@ Load a reference with `skillLoad` (`fimo-cli`, reference `<name>`). "+ fimo-code
|
|
|
29
29
|
- Generate or edit an image or video with AI → `media` (+ fimo-code `assets` to show it on the site)
|
|
30
30
|
- Labels, static copy, missing `t()` values → `labels` + fimo-code `labels`
|
|
31
31
|
- Locales → `locales` + fimo-code `locales`
|
|
32
|
-
- Preview URL → `preview`;
|
|
32
|
+
- Current Branch or main Preview URL → `preview`; failed builds and logs → `deploy`
|
|
33
33
|
- Redirects, security headers, clean URLs, trailing slash → `hosting`
|
|
34
34
|
- Broken links, SEO, alt text, accessibility, Web Vitals, console errors in a browser → `site-checks`
|
|
35
35
|
- Restore points → `history`
|
|
@@ -46,7 +46,7 @@ fimo domains remove <hostname> --yes
|
|
|
46
46
|
- `add` returns the DNS records (usually a CNAME and a TXT) that the user sets at their registrar; with `--json` they are in the domain record. Give them to the user exactly.
|
|
47
47
|
- After the user sets DNS, run `refresh` once; it polls until SSL is active or the wait ends (`--no-wait` prints one status). Read the returned status: the end of a wait does not prove the domain works. Do not run `refresh` in a loop. DNS can take from minutes to 48 hours.
|
|
48
48
|
- In an interactive setup, omit `--wait` on `add` so the user gets the records at once. In CI, `--wait` polls until the domain is verified or the wait ends.
|
|
49
|
-
- The primary domain is the canonical host of the published site. Fimo picks the oldest serving domain until the user chooses one with `primary`; the domain must be active with its certificate issued, else `DOMAIN_NOT_SERVING`. The canonical links change only on the next publish, so tell the user to publish again.
|
|
49
|
+
- The primary domain is the canonical host of the published site. Fimo picks the oldest serving domain until the user chooses one with `primary`; the domain must be active with its certificate issued, else `DOMAIN_NOT_SERVING`. The canonical links change only on the next publish, so tell the user to publish again. Change the site's address this way. A `seo.url` in `.fimo/config.json` overrides the primary domain and stops the site from following it: set it only when the user asks for an address Fimo does not serve, such as one behind their own proxy, and say that a later primary change will not move it.
|
|
50
50
|
- Each custom domain serves the site or redirects to another domain of the same site. `redirect` defaults to 307 (temporary); use 308 or 301 only when the user says the move is permanent. `list` shows each destination (`-> 308 www.acme.com` or `serves`). The target must serve and have its certificate issued, and redirects never chain: a refusal comes back with its code (`REDIRECT_TARGET_REDIRECTS`, `REDIRECT_SOURCE_IS_TARGET`, `REDIRECT_TARGET_NOT_ACTIVE`, `REDIRECT_TARGET_NOT_IN_PROJECT`, `INVALID_REDIRECT_STATUS`), and `add --redirect-www` gets `REDIRECT_TARGET_REDIRECTS` when the site's `www` already redirects elsewhere. Tell the user what it says; never point other domains elsewhere on your own.
|
|
51
51
|
- `remove` also removes every domain that redirects to the one removed. Run it once without `--yes`: in a run without prompts it refuses with `NON_INTERACTIVE_REFUSAL`, and its hint names those domains. Show that list to the user, and pass `--yes` only after they agree to remove them all.
|
|
52
52
|
- A redirect on the primary domain, `serve` on a domain that becomes primary, or removing the primary domain moves the primary domain; the result's hint says so. Tell the user to publish again so canonical links use it.
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
Use `fimo preview url` to get the current Branch's hosted preview without committing or pushing.
|
|
4
4
|
|
|
5
|
+
In Studio, unflagged `preview url` stays on the task or tab Branch. Only `preview url --branch main` or
|
|
6
|
+
`preview url --branch=main` may select another Branch, with one selector per call. Local CLI use can select any
|
|
7
|
+
accessible Branch, as in the `feat/redesign` example below.
|
|
8
|
+
|
|
5
9
|
```bash
|
|
6
10
|
fimo preview url
|
|
7
11
|
fimo --branch feat/redesign preview url
|
|
@@ -11,6 +15,9 @@ curl -L "$(fimo preview url)"
|
|
|
11
15
|
|
|
12
16
|
The command returns the hosted deployment URL in every output mode: every live Branch except production owns a hosted build.
|
|
13
17
|
|
|
18
|
+
Main's Preview can contain unpublished changes. For what visitors receive, use the published address from
|
|
19
|
+
`domains list` and verify it answers.
|
|
20
|
+
|
|
14
21
|
If the current generation is queued or building, the command waits up to five minutes, polling with a backoff. It stops at once — without waiting — on a state waiting cannot change: a build that failed, and a Branch with no hosted preview (production, or a Branch nothing has changed yet). Every failure returns `PREVIEW_URL_FAILED`; read `error.message` for which one it was and `error.hint` for the next step. Only the timeout is worth retrying.
|
|
15
22
|
|
|
16
23
|
JSON output contains only the Branch identity and hosted URL:
|
|
@@ -24,6 +24,8 @@ Nodes: `doc`, `paragraph`, `heading`, `bulletList`, `orderedList`, `listItem`, `
|
|
|
24
24
|
|
|
25
25
|
Marks: `bold`, `italic`, `underline`, `strike`, `code`, and `link`.
|
|
26
26
|
|
|
27
|
+
Link to a page of the same site by its path (`/pricing`), even when older content uses full addresses. A full address always opens the published site: from a draft or preview it leaves what the reader is reviewing, it cannot reach a page that is not published yet, and it breaks when the primary domain changes. Use a full address only for another site.
|
|
28
|
+
|
|
27
29
|
Use semantic nodes instead of flattening long content into paragraphs. Render the returned value with the framework's `<RichText>` primitive so source metadata survives.
|
|
28
30
|
|
|
29
31
|
Richtext and other API values may carry class-backed tracking metadata. Values
|
|
@@ -57,8 +57,9 @@ explicit `undefined` in a spread removes a field; use conditional spreads to
|
|
|
57
57
|
retain defaults for missing optional overrides. Resolve once, then compose;
|
|
58
58
|
do not resolve again after applying policy.
|
|
59
59
|
|
|
60
|
-
A resolved `seo.url` is the site's address:
|
|
61
|
-
set, otherwise the
|
|
60
|
+
A resolved `seo.url` is the site's address: `seo.url` in `.fimo/config.json`
|
|
61
|
+
when the owner set it, otherwise the platform's `FIMO_SITE_URL` (the primary
|
|
62
|
+
domain, else the built-in address).
|
|
62
63
|
Read it from the resolved SEO, not from the imported config.
|
|
63
64
|
|
|
64
65
|
Pass a final absolute canonical URL from the app's production URL policy.
|
|
@@ -52,7 +52,8 @@ Hover over a message. Your messages have **Copy** and **Edit** (change and resen
|
|
|
52
52
|
## Proposals, reviews and merges
|
|
53
53
|
|
|
54
54
|
- Ask chat to keep alternatives as named proposals. Open the Branch picker and choose one under **Proposals** to preview it; each has its own changes. Internal work stays hidden there, even when saved or kept longer. Exploring or merging one keeps the others unless you ask to discard them. Delete a proposal from the Branch picker. Pull is not available for a proposal: ask chat to update it. **New Branch** starts from the proposal's upstream; merge the proposal first to branch from its changes.
|
|
55
|
-
- A
|
|
55
|
+
- A request is made at once. When a decision is still yours, such as ideas you asked to pick from or a change a routine found, chat proposes instead: a block with one line per proposal (spinner: still being written, arrow: ready, check: approved, crossed out: discarded). A line opens the proposal beside the chat, or as its own page on a phone: new or changed content as a page of text you can edit (your edits stay in the proposal, nothing is live), and a change to how a page looks or works as that page's preview. **Approve** sends `Approve "<title>"` to the chat, and the agent writes it to your preview, or first makes a change you asked for there; if someone changed the same field since, nothing is overwritten and the agent says what changed. **Discard** removes it at once.
|
|
56
|
+
- A session proposal saves the session's current work and makes that same session visible and durable. It shows in a strip above the message box (**View changes**, **Open preview**), and the conversation keeps a line with **View changes** where it was proposed. Opening it approves nothing. The Preview and Changes links, also in Slack or an agent report, open the Branch in Studio and need site access.
|
|
56
57
|
- Chat prepares changes separately and merges them into the environment you view; most merge automatically. If the site changed in the same place, a banner above the message box (**Your last changes need attention**) offers **Auto fix** (chat continues in the retained proposal, resolves the conflict and retries the merge; keep chatting has the same effect) and **Review manually**. Discarding leaves the environment unchanged and removes the proposal for good.
|
|
57
58
|
- **Merging does not publish the site.**
|
|
58
59
|
|