fimo 0.2.5-experimental.1782385179125 → 0.2.5-staging.14

package/assets/skills/fimo/references/locales.md

@@ -14,7 +14,7 @@ Fimo provides locale utilities that follow the Fimo standard, but they are helpe
     "routing": {
       "strategy": "path-prefix", // only supported strategy: /es/about for Spanish; default locale can stay /about
       "prefixDefaultLocale": false, // when false, omit /en for the default locale
-    }
+    },
   },
 }
 ```

package/assets/skills/fimo-cli/SKILL.md

@@ -69,6 +69,7 @@ Load the matching reference when the user's request fires its trigger. Recipes t
 - "What's in this project / show the project structure / describe the project / what schemas does it have / how many routes / project tree / show me what's here" → `references/describe.md`
 - "Deploy / publish / go live / push my changes" → `references/deploy.md`
 - "Get the preview URL / open the preview / what's the URL for this env / refresh the preview link / I just want to see the site / the preview URL stopped working" → `references/preview.md`
+- "Schedule a command / cron / nightly publish / recurring checks / `fimo schedules`" → `references/schedules.md`
 - "Set env vars / configure API keys / add project secrets / local `.env.local` / `fimo vars` / `fimo secrets`" → `references/project-vars-and-secrets.md`
 - "Enable provider tools / integrations / API key connection for a provider / agent integration access" → `references/integrations.md`
 - "Firecrawl / scrape a public website / competitor research / agent web research" → `references/integrations.md` **+ load `references/integrations/firecrawl.md`**

package/assets/skills/fimo-cli/references/locales.md

@@ -14,7 +14,7 @@ Edit `fimo-config.json`. Keep one locale unless the user asks for multilingual o
     "routing": {
       "strategy": "path-prefix", // only supported strategy: /es/about for Spanish; default locale can stay /about
       "prefixDefaultLocale": false, // when false, omit /en for the default locale
-    }
+    },
   },
 }
 ```

package/assets/skills/fimo-cli/references/schedules.md

@@ -0,0 +1,46 @@
+# Scheduled Commands
+
+`fimo schedules` manages recurring commands for a project env. A schedule is scoped to the env of the current checkout by default, or to `--env <name>` when passed.
+
+## Commands
+
+```bash
+fimo schedules create <name> --cron "0 2 * * *" --do "fimo publish"
+fimo schedules create smoke --cron "*/15 * * * *" --do "pnpm test"
+fimo schedules list
+fimo schedules run <name>
+fimo schedules delete <name>
+```
+
+## Runtime Model
+
+Scheduled commands run in the project's env runtime, not on the user's machine. On each run, Fimo prepares the env, refreshes the project files and dependencies, authenticates as the schedule owner, then executes the stored command from the project root.
+
+`--do` can be any CLI command that makes sense for the project, such as `fimo publish`, `fimo validate`, `pnpm test`, or a project script.
+
+Cron expressions use standard five-field syntax. Schedules must not run more often than every five minutes.
+
+## Useful Patterns
+
+Nightly publish:
+
+```bash
+fimo schedules create nightly --cron "0 2 * * *" --do "fimo publish"
+```
+
+Recurring smoke test:
+
+```bash
+fimo schedules create smoke --cron "*/15 * * * *" --do "pnpm test"
+```
+
+Manual run without waiting for cron:
+
+```bash
+fimo schedules run smoke
+```
+
+## Notes
+
+- `list`, `run`, and `delete` operate on the current checkout env unless `--env` is passed.
+- A failed command marks the schedule `failed`, stores the error/log excerpt, and `fimo schedules run` exits non-zero.

package/dist/build/vite/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/build/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAC;AAwEjD,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAGD,wBAAgB,IAAI,CAAC,IAAI,GAAE,eAAoB,GAAG,YAAY,EAAE,CAsB/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/build/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAC;AAyEjD,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAGD,wBAAgB,IAAI,CAAC,IAAI,GAAE,eAAoB,GAAG,YAAY,EAAE,CAsB/D"}

package/dist/build/vite/index.js

@@ -34,6 +34,7 @@ function bundleFimoIntoSsrPlugin() {
         config: () => ({
             ssr: { noExternal: ['fimo'] },
             optimizeDeps: {
+                include: ['fimo/ui'],
                 esbuildOptions: {
                     plugins: [
                         {

package/dist/build/vite/plugins/translations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../src/build/vite/plugins/translations.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAQlD,UAAU,WAAW;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAuBD,MAAM,CAAC,OAAO,UAAU,kBAAkB,IAAI,MAAM,CA2MnD;AAqCD,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwC3E"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../src/build/vite/plugins/translations.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAQlD,UAAU,WAAW;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAwCD,MAAM,CAAC,OAAO,UAAU,kBAAkB,IAAI,MAAM,CAmOnD;AAoED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwC3E"}

package/dist/build/vite/plugins/translations.js

@@ -34,7 +34,21 @@ export default function translationsPlugin() {
         for (const mod of findVirtualTranslationModules(devServer)) {
             devServer.moduleGraph.invalidateModule(mod);
         }
-        devServer.ws.send({ type: 'full-reload', path: '*' });
+        devServer.ws.send({
+            type: 'custom',
+            event: 'fimo:labels-updated',
+            data: labelUpdatePayload(bundle),
+        });
+    };
+    const emitContentUpdate = (payload) => {
+        if (!devServer) {
+            return;
+        }
+        devServer.ws.send({
+            type: 'custom',
+            event: 'fimo:content-updated',
+            data: payload,
+        });
     };
     const scheduleRefresh = () => {
         if (refreshTimer) {
@@ -161,6 +175,10 @@ export default function translationsPlugin() {
                 }
                 try {
                     const message = JSON.parse(raw);
+                    if (message.type === 'content:changed') {
+                        emitContentUpdate(parseContentChangePayload(message.payload));
+                        return;
+                    }
                     if (message.type !== 'labels:changed') {
                         return;
                     }
@@ -190,6 +208,27 @@ export default function translationsPlugin() {
         return sockets;
     }
 }
+function parseContentChangePayload(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return { changes: [] };
+    }
+    const source = payload;
+    const changes = Array.isArray(source.changes)
+        ? source.changes
+            .filter((change) => Boolean(change) && typeof change === 'object')
+            .map((change) => ({
+            action: typeof change.action === 'string' ? change.action : undefined,
+            contentType: typeof change.contentType === 'string' ? change.contentType : undefined,
+            documentId: typeof change.documentId === 'string' ? change.documentId : undefined,
+            id: typeof change.id === 'string' ? change.id : undefined,
+            locale: typeof change.locale === 'string' ? change.locale : undefined,
+        }))
+        : [];
+    return {
+        changes,
+        updatedAt: typeof source.updatedAt === 'string' ? source.updatedAt : undefined,
+    };
+}
 function serializeBundle(bundle) {
     return JSON.stringify({
         dictionaries: bundle.dictionaries,
@@ -221,6 +260,12 @@ function findVirtualTranslationModules(server) {
 function labelSignature(bundle) {
     return Buffer.from(serializeBundle(bundle)).toString('base64');
 }
+function labelUpdatePayload(bundle) {
+    return {
+        ...bundle,
+        signature: labelSignature(bundle),
+    };
+}
 export async function loadLabelBundle(rootDir) {
     const config = getConfigServer(rootDir);
     const defaultLocale = getFimoDefaultLocale(config);
@@ -379,7 +424,7 @@ async function generateOneTimeToken(apiUrl) {
         throw new Error('Not signed in to Fimo.');
     }
     const response = await fetch(new URL('/api/auth/one-time-token/generate', apiUrl), {
-        method: 'POST',
+        method: 'GET',
         headers: {
             Authorization: `Bearer ${bearer}`,
         },

package/dist/build/vite/plugins/translations.test.js

@@ -110,7 +110,7 @@ describe('translationsPlugin', () => {
         expect(source).toContain('export const translations = {};');
         expect(source).toContain('export const defaultLocale = "es";');
     });
-    it('invalidates the dev page when background labels arrive', async () => {
+    it('pushes updated labels over custom HMR without a full page reload', async () => {
         const root = createProjectRoot();
         mockLabels({ headline: 'Hola' });
         const plugin = createPlugin(root, 'serve');
@@ -121,7 +121,18 @@ describe('translationsPlugin', () => {
         }
         plugin.configureServer.call(pluginContext, server);
         await waitFor(() => server.ws.send.mock.calls.length > 0);
-        expect(server.ws.send).toHaveBeenCalledWith({ type: 'full-reload', path: '*' });
+        expect(server.ws.send).toHaveBeenCalledWith({
+            type: 'custom',
+            event: 'fimo:labels-updated',
+            data: expect.objectContaining({
+                defaultLocale: 'es',
+                dictionaries: { es: { headline: 'Hola' } },
+                locales: ['es'],
+                signature: expect.any(String),
+                updatedAt: '2026-06-24T00:00:00.000Z',
+            }),
+        });
+        expect(server.ws.send).not.toHaveBeenCalledWith({ type: 'full-reload', path: '*' });
         const source = await loadTranslations(plugin);
         expect(source).toContain('"headline":"Hola"');
     });
@@ -141,7 +152,7 @@ describe('translationsPlugin', () => {
             }
             close() { }
         });
-        vi.stubGlobal('fetch', vi.fn(async (input) => {
+        const fetchMock = vi.fn(async (input, init) => {
             const url = new URL(input.toString());
             if (url.pathname === '/labels') {
                 return jsonResponse({ data: { labels: {}, updatedAt: null } });
@@ -150,10 +161,12 @@ describe('translationsPlugin', () => {
                 return jsonResponse({ data: { eventsServerUrl: 'https://events.example.test' } });
             }
             if (url.pathname === '/api/auth/one-time-token/generate') {
-                return jsonResponse({ data: { token: 'event-token' } });
+                expect(init?.method).toBe('GET');
+                return jsonResponse({ token: 'event-token' });
             }
             return { ok: false, json: async () => ({}) };
-        }));
+        });
+        vi.stubGlobal('fetch', fetchMock);
         const plugin = createPlugin(root, 'serve');
         await buildStart(plugin);
         const server = createDevServer();
@@ -165,6 +178,62 @@ describe('translationsPlugin', () => {
         expect(socketUrls[0]).toContain(`wss://events.example.test/parties/events/${projectId}`);
         expect(socketUrls[0]).toContain('authToken=event-token');
     });
+    it('forwards content changes over custom HMR without a full page reload', async () => {
+        const root = createProjectRoot();
+        const projectId = '11111111-1111-4111-8111-111111111111';
+        writeFileSync(join(root, '.fimo.settings.json'), JSON.stringify({ projectId, apiUrl: 'https://api.example.test' }));
+        process.env.FIMO_API_TOKEN = 'test-api-token';
+        const sockets = [];
+        vi.stubGlobal('WebSocket', class {
+            onopen = null;
+            onmessage = null;
+            onclose = null;
+            onerror = null;
+            constructor(_url) {
+                sockets.push(this);
+            }
+            close() { }
+        });
+        vi.stubGlobal('fetch', vi.fn(async (input) => {
+            const url = new URL(input.toString());
+            if (url.pathname === '/labels') {
+                return jsonResponse({ data: { labels: {}, updatedAt: null } });
+            }
+            if (url.pathname === '/runtime-config') {
+                return jsonResponse({ data: { eventsServerUrl: 'https://events.example.test' } });
+            }
+            if (url.pathname === '/api/auth/one-time-token/generate') {
+                return jsonResponse({ data: { token: 'event-token' } });
+            }
+            return { ok: false, json: async () => ({}) };
+        }));
+        const plugin = createPlugin(root, 'serve');
+        await buildStart(plugin);
+        const server = createDevServer();
+        if (typeof plugin.configureServer !== 'function') {
+            throw new Error('Expected configureServer hook');
+        }
+        plugin.configureServer.call(pluginContext, server);
+        await waitFor(() => sockets.length > 0);
+        sockets[0].onmessage?.({
+            data: JSON.stringify({
+                type: 'content:changed',
+                payload: {
+                    changes: [{ action: 'update', contentType: 'LiveNote', id: 'entry-1', locale: 'en' }],
+                    updatedAt: '2026-06-24T00:00:00.000Z',
+                },
+            }),
+        });
+        expect(server.ws.send).toHaveBeenCalledWith({
+            type: 'custom',
+            event: 'fimo:content-updated',
+            data: {
+                changes: [{ action: 'update', contentType: 'LiveNote', id: 'entry-1', locale: 'en' }],
+                updatedAt: '2026-06-24T00:00:00.000Z',
+            },
+        });
+        expect(server.ws.send).not.toHaveBeenCalledWith({ type: 'full-reload', path: '*' });
+    });
     it('still waits for labels during production builds', async () => {
         const root = createProjectRoot();
         const fetchMock = mockLabels({ headline: 'Hola' });

package/dist/cli/bundle.json

@@ -1,8 +1,8 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-06-25T10:59:49.127Z",
-  "cliVersion": "0.2.5-experimental.1782385179125",
+  "bundledAt": "2026-06-26T17:21:55.057Z",
+  "cliVersion": "0.2.5-staging.14",
   "external": [
     "oxc-parser",
     "fsevents"