fimo 2.13.0 → 2.14.1-staging.1

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.
@@ -43,30 +43,31 @@ When a reference says "open X", X can be inside **More** on a narrow window.
43
43
 
44
44
  Read the relevant reference file when the user's question matches a topic.
45
45
 
46
- | Topic | Reference | When to read |
47
- | ------------------------ | --------------------------------------- | ---------------------------------------------------------------------- |
48
- | Command Palette | references/command-palette.md | "What can I open with Cmd+K?", "Quick actions" |
49
- | Publish & Deploy | references/publish-and-deploy.md | "How do I publish?", "How do I make my site live?" |
50
- | Analytics | references/analytics.md | "Is tracking working?", "Why are analytics empty?" |
51
- | Custom Domains | references/custom-domains.md | "How do I use my own domain?", "DNS setup" |
52
- | Content Management (CMS) | references/cms.md | "How does the CMS work?", "How do I add blog posts?" |
53
- | Media Library | references/media-library.md | "How do I upload images?", "Where are my files?" |
54
- | AI Chat | references/ai-chat.md | "What can the AI do?", "How do I give context?" |
55
- | Agents | references/ai-chat/agents.md | "Which plan has which agents?", "New agent", "Why is my agent paused?" |
56
- | Default agents | references/ai-chat/default-agents.md | "What does the SEO agent check?", "Which routines run on Monday?" |
57
- | Routines | references/ai-chat/routines.md | "When does a routine run?", "Routines paused", "Watch a price page" |
58
- | Site Knowledge | references/knowledge.md | "Set brand guidance", "Website goals", "Draft knowledge from the site" |
59
- | SEO Settings | references/seo-settings.md | "How do I set up SEO?", "Favicon, title, share image" |
60
- | Variables & Secrets | references/variables-and-secrets.md | "Where do I put an API key?", "Public or private variable?" |
61
- | Schedules | references/schedules.md | "Recurring commands", "Run history", "Run now" |
62
- | Webhooks | references/webhooks.md | "React to forms", "Send events to another service" |
63
- | Integrations | references/integrations.md | "Connect a service", "Add an MCP server", "Slack channels" |
64
- | Preview & Responsive | references/preview-and-responsive.md | "How does it look on mobile?", "How do I test sizes?" |
65
- | Visual Editing | references/visual-editing.md | "Can I edit visually?", "How do I change colors?" |
66
- | Version History | references/version-history.md | "How do I undo?", "How do I go back?" |
67
- | Sharing & Collaboration | references/sharing-and-collaboration.md | "How do I share?", "How do I invite someone?" |
68
- | Site Creation | references/project-creation.md | "How do I start a new site?" |
69
- | Billing & Credits | references/billing-and-credits.md | "What are credits?", "How do I upgrade?", "How do referrals work?" |
46
+ | Topic | Reference | When to read |
47
+ | ------------------------ | --------------------------------------- | ------------------------------------------------------------------------ |
48
+ | Command Palette | references/command-palette.md | "What can I open with Cmd+K?", "Quick actions" |
49
+ | Publish & Deploy | references/publish-and-deploy.md | "How do I publish?", "How do I make my site live?" |
50
+ | Analytics | references/analytics.md | "Is tracking working?", "Why are analytics empty?" |
51
+ | Custom Domains | references/custom-domains.md | "How do I use my own domain?", "DNS setup" |
52
+ | Content Management (CMS) | references/cms.md | "How does the CMS work?", "How do I add blog posts?" |
53
+ | Media Library | references/media-library.md | "How do I upload images?", "Where are my files?" |
54
+ | AI Chat | references/ai-chat.md | "What can the AI do?", "How do I give context?" |
55
+ | Agents | references/ai-chat/agents.md | "Which plan has which agents?", "New agent", "Why is my agent paused?" |
56
+ | Default agents | references/ai-chat/default-agents.md | "What does the SEO agent check?", "Which routines run on Monday?" |
57
+ | Routines | references/ai-chat/routines.md | "When does a routine run?", "Routines paused", "Watch a price page" |
58
+ | Site Knowledge | references/knowledge.md | "Set brand guidance", "Website goals", "Draft knowledge from the site" |
59
+ | SEO Settings | references/seo-settings.md | "How do I set up SEO?", "Favicon, title, share image" |
60
+ | Variables & Secrets | references/variables-and-secrets.md | "Where do I put an API key?", "Public or private variable?" |
61
+ | Schedules | references/schedules.md | "Recurring commands", "Run history", "Run now" |
62
+ | Webhooks | references/webhooks.md | "React to forms", "Send events to another service" |
63
+ | Code Sync | references/code-sync.md | "Sync code to GitHub", "Connect a repository", "Resolve a sync conflict" |
64
+ | Integrations | references/integrations.md | "Connect a service", "Add an MCP server", "Slack channels" |
65
+ | Preview & Responsive | references/preview-and-responsive.md | "How does it look on mobile?", "How do I test sizes?" |
66
+ | Visual Editing | references/visual-editing.md | "Can I edit visually?", "How do I change colors?" |
67
+ | Version History | references/version-history.md | "How do I undo?", "How do I go back?" |
68
+ | Sharing & Collaboration | references/sharing-and-collaboration.md | "How do I share?", "How do I invite someone?" |
69
+ | Site Creation | references/project-creation.md | "How do I start a new site?" |
70
+ | Billing & Credits | references/billing-and-credits.md | "What are credits?", "How do I upgrade?", "How do referrals work?" |
70
71
 
71
72
  ## Cross-feature references
72
73
 
@@ -4,18 +4,18 @@ Plans, setup and the rules every default agent follows are in `ai-chat/agents`.
4
4
 
5
5
  ## SEO (8 routines)
6
6
 
7
- - **Technical SEO:** status, redirects, canonicals, sitemap, robots.txt, language, main heading, and what got worse since its last run: pages moved without a redirect and, with Search Console, old addresses Google still shows that the site no longer serves. Runs on changes, the first publish, a new domain, and every Monday.
7
+ - **Technical SEO:** status, redirects, canonicals, sitemap, robots.txt, language, main heading, and what got worse since its last run: pages moved without a redirect and, with Search Console, old addresses Google still shows that the site no longer serves, and pages of the domain another system serves (an app's sign-in, docs) that cost the site in search, told once with the fix and who owns it. Runs on changes, the first publish, a new domain, and every Monday.
8
8
  - **Broken links:** links to the site's own pages that fail or pass through a redirect. Runs on changes; links to other sites on the 1st of each month.
9
9
  - **Meta tags:** titles, descriptions and Open Graph previews that are missing, repeated, or too long or short (characters and pixels), and titles that do not end like the site's other titles. Runs on changes and every Monday.
10
10
  - **Image SEO:** alt text, file names, and images over 200 KB. An image in the media library is rendered through Fimo's resizing; a file of the site is uploaded first. An image on another host gets a proposal for a smaller export.
11
11
  - **Hreflang:** on a site in more than one language, each version lists the others.
12
12
  - **Internal linking:** orphan pages, pages more than three clicks deep, and articles with no link to a hub or product page or more than eight links. Runs on changes and every Monday.
13
- - **Keyword optimization** (every Tuesday, needs Search Console): for pages ranking 8th to 20th it writes a title and headings from the searches that bring visitors, keeps the old words, and checks 8 weeks later whether they helped; on a clear loss it puts the old words back.
13
+ - **Keyword optimization** (every Tuesday, needs Search Console): pages ranking 4th to 20th. A page of another kind than the top results is left as is, with one offer to prepare that kind as a proposal (a small search: a note only). When the pages above win on links from other sites, it says so. Else it rewrites title and headings (8th to 20th; Meta tags owns titles at 4th to 7th) or proposes, with why, the section several top results cover and the page lacks. It links inside the site alone when the linking text has the words, else proposes the link. It judges a change against unchanged pages once Google rereads it, calls too few impressions too little data, and undoes a clear loss.
14
14
  - **Keyword research** (2nd of each month): proposes at most five pages and asks which to write; the Content agent's Writing routine writes the ones picked.
15
15
 
16
16
  The Monday runs of Technical SEO, Meta tags and Internal linking read every page of main's hosted preview, for what no single change shows (pages out of the sitemap, shared titles, title shape, orphan and deep pages). A run that a change started checks only the pages it touches, its first run too.
17
17
 
18
- Alone, it points a link at a new address only after it checked that the address shows the same content in the same language, and otherwise removes a dead link and keeps its words; it adds a link on words the text already uses to name another page, keeps the 8 most useful links on a page with too many, shortens a title or description Google cuts from the same words (in a field only search reads, added to the type when needed, when the title is also the page's heading), sets the public address when the canonicals and sitemap agree on it, and adds a 301 from a page's old address once the same page is live at the new one. A title, description, heading or link that any agent or person changed is not changed again for 8 weeks (Google needs 8 to 12 weeks to show the effect), unless it is a fault, and words a person rewrote after an agent changed them stay. Keyword research never changes the site alone.
18
+ Alone, it points a link at a new address only after it checked that the address shows the same content in the same language, and otherwise removes a dead link and keeps its words; it adds a link on words the text already uses to name another page, keeps the 8 most useful links on a page with too many, shortens a title or description Google cuts from the same words (in a field only search reads, added to the type when needed, when the title is also the page's heading), sets the public address when the canonicals and sitemap agree on it, adds a 301 from an old address Google still shows once one live page clearly covers the same subject (none: the address stays gone; several: it asks), and gives a page whose address says nothing (`/blog/blog-post-9a32c70f0f`) a readable one from its title, with a 301 from the old one. A title, description, heading or link that any agent or person changed is not changed again for 8 weeks (Google shows the effect weeks after it rereads a page), unless it is a fault, and words a person rewrote after an agent changed them stay. Keyword research never changes the site alone.
19
19
 
20
20
  ## GEO (4 routines)
21
21
 
@@ -20,6 +20,8 @@ A trigger is set in words. Fimo checks them and says when the routine runs, or w
20
20
 
21
21
  Comparing a field's old and new values ("the price goes up by 10%") is not supported. For what Fimo cannot see as an event (traffic, rankings, errors), the agent offers a schedule whose run checks it and stops when there is nothing to do.
22
22
 
23
+ **Unpublished sites:** until the site is published, a schedule runs a routine the first time and then only when a person wrote or opened a chat of the project, or pressed **Run now**, since its previous run; otherwise the slot is skipped, leaves no run, and the next slot asks again, so a site someone tried and left does not spend credits every week. Events and **Run now** always run.
24
+
23
25
  **Chains:** what a routine changes, publishes or reports can start the agent's other routines, in chains of any length. Each routine runs at most once per change that started the chain, so routines never loop or multiply. A person's new change, or a run by hand or on a schedule, starts a new chain.
24
26
 
25
27
  **Waiting events:** events that come in while a run is busy wait, then run together in the next run; the Runs list shows one run with its event count. A very large burst, such as a bulk import, runs in several runs, in order. The agent can make a routine's event runs wait until the changes stop for a set number of minutes (at most 2 hours from the first), then read them in one run. A yes/no question is then answered once for all the waiting changes, each entry once in its latest version; a change it says no to leaves the queue, and when it says no to all, no run starts. Default routines that read what changed wait 10 minutes after the last change (Technical SEO, Meta tags, Image SEO, Internal linking, AI readiness, Structured data, AI citation optimization, Content lifecycle, Translation, Accessibility, Mobile optimization, Brand compliance); Editable copy waits 30 minutes; those that guard the live site (Broken links, Hreflang, Cookie consent, Privacy and legal pages) run at once.
@@ -25,7 +25,7 @@ Open **Earn free credits** from the site header (or the site menu on mobile), th
25
25
  - **Published** counts people who published their first site, not the number of sites they publish.
26
26
  - **AI credits earned** shows inviter rewards already credited to you. It excludes your own bonus for joining through someone else's link; a publication can appear before its reward is credited.
27
27
 
28
- Each signup uses one of the five referral slots. Publishing unlocks the reward but does not reopen a slot. The dialog shows signups used and how many people have not published yet. **Terms and Conditions** opens the program terms; **Close** dismisses the dialog.
28
+ Each signup uses one of the five referral slots. The reward unlocks when that person publishes a site at least a day after signing up, and is credited to the referrer's personal organization; publishing does not reopen a slot. Someone who joined through a referral can't refer others, so their dialog shows a notice instead of a link. The dialog shows signups used and how many people have not published yet. **Terms and Conditions** opens the program terms; **Close** dismisses the dialog.
29
29
 
30
30
  ## Buying More Credits
31
31
 
@@ -0,0 +1,19 @@
1
+ # Code Sync
2
+
3
+ Code Sync appears only when available for the organization. If access is disabled, connections and checkpoints are kept;
4
+ eligible syncs resume when access returns, while conflicts still need **Check and resume**.
5
+
6
+ In a site's **Settings**, open **Code Sync** under **Advanced**, then **Add connection** → **Connect GitHub**.
7
+ A site manager connects an account and selects a repository or creates one. New repositories default to private;
8
+ public requires an explicit choice. Each connection automatically syncs current and future persistent Fimo branches
9
+ under the same names. Temporary agent branches and internal deployment refs are excluded. A public repository exposes
10
+ all synced branches. Code and Git history are copied; content, media and databases are not.
11
+
12
+ An occupied branch or external changes block only that branch; healthy branches keep syncing. Fimo never overwrites
13
+ unknown history. For an initial collision, preserve the existing branch under another name before **Check and resume**.
14
+ For a previously synced branch, manually restore its acknowledged checkpoint, then **Check and resume**.
15
+ Source deletion preserves the external branch. Recreating a source branch requires a manual check.
16
+ Use **Check access** or **Reconnect** to repair provider access; this does not clear branch conflicts.
17
+ **Remove connection** stops future syncs after any accepted write finishes, preserving the external repository.
18
+ Re-adding the same repository to the same site restores its checkpoints after fresh authorization; conflicts remain blocked.
19
+ Remove all connections before transferring the site. Manage Code Sync in Studio; it does not expose integration tools.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "bundled": true,
3
3
  "bundler": "esbuild",
4
- "bundledAt": "2026-11-10T13:57:13.779Z",
5
- "cliVersion": "2.13.0",
4
+ "bundledAt": "2026-11-11T17:10:05.324Z",
5
+ "cliVersion": "2.14.0",
6
6
  "external": [
7
7
  "oxc-parser",
8
8
  "fsevents",