fimo 2.4.0-staging.8 → 2.4.0
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.md +1 -0
- package/assets/skills/fimo-cli/references/site-checks.md +73 -0
- package/dist/cli/bundle.json +2 -2
- package/dist/cli/index.js +2 -2
- package/package.json +8 -8
- package/release.json +2 -2
- package/templates/astro/package.json +2 -2
- package/templates/nextjs/package.json +3 -3
- package/templates/react-router/package.json +4 -4
- package/templates/sveltekit/package.json +2 -2
- package/templates/vite/package.json +4 -4
|
@@ -91,6 +91,7 @@ Load the matching reference when the user's request fires its trigger. Recipes t
|
|
|
91
91
|
- "Deploy / publish / go live / push my changes" → `references/deploy.md`
|
|
92
92
|
- "Add a redirect / security headers / CSP / HSTS / clean URLs / trailing slash" → `references/hosting.md`
|
|
93
93
|
- "Get the preview URL / open the preview / what's the URL for this Branch / refresh the preview link / I just want to see the site / the preview URL stopped working" → `references/preview.md`
|
|
94
|
+
- "Check the site in a browser / is my site accessible / a11y or WCAG check / measure LCP or Web Vitals / why is the page slow / inspect network requests or console errors / Lighthouse score" → `references/site-checks.md`
|
|
94
95
|
- "Schedule a command / cron / nightly publish / recurring checks / `fimo schedules`" → `references/schedules.md`
|
|
95
96
|
- "Set env vars / configure API keys / add project secrets / local `.env.local` / `fimo vars` / `fimo secrets`" → `references/project-vars-and-secrets.md`
|
|
96
97
|
- "React to form submissions / publish changes / agent runs / analytics reports / media activity / send events to Resend, Slack, GitHub, Zapier, or an HTTP endpoint / configure or debug outbound webhooks" → `references/webhooks.md`
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Site checks
|
|
2
|
+
|
|
3
|
+
Start from a URL the agent can actually reach, then use the inspection tools
|
|
4
|
+
available in its runtime. This reference owns Fimo target selection and the
|
|
5
|
+
meaning of the evidence. Browser and audit tools own their commands.
|
|
6
|
+
|
|
7
|
+
## 1. Pick a target and name it
|
|
8
|
+
|
|
9
|
+
- An already-running local development server.
|
|
10
|
+
- An existing hosted Fimo preview: run `fimo preview url --json` and use
|
|
11
|
+
`data.sandbox_url` (see `references/preview.md`).
|
|
12
|
+
- A URL the user supplied, including an existing published site.
|
|
13
|
+
|
|
14
|
+
Never run `fimo deploy` just to retrieve a preview URL. Do not run `fimo
|
|
15
|
+
publish` or `fimo deploy --publish` merely to create a measurement target.
|
|
16
|
+
For any other deployment or publishing decision, follow the current run's
|
|
17
|
+
authority rules and `references/deploy.md`.
|
|
18
|
+
|
|
19
|
+
A local server or preview can prove how that target renders and behaves. Its
|
|
20
|
+
timings describe that environment, not the published site. A supplied public
|
|
21
|
+
URL can describe the live version, but one synthetic run is not field data.
|
|
22
|
+
|
|
23
|
+
## 2. Use the tools that exist
|
|
24
|
+
|
|
25
|
+
Inspect the available tools and skills before choosing a method.
|
|
26
|
+
|
|
27
|
+
- If `agent-browser` is available, load its skill and version-matched `core`
|
|
28
|
+
guidance before using it.
|
|
29
|
+
- Otherwise use equivalent browser automation, accessibility, HTTP, network,
|
|
30
|
+
profiling, or performance tools exposed by the current runtime.
|
|
31
|
+
- HTTP-only tools can prove fetchability, status, headers, and raw content.
|
|
32
|
+
They cannot prove visual layout, interactions, or accessibility.
|
|
33
|
+
- Fimo CLI does not produce Lighthouse reports, and `agent-browser` Web Vitals
|
|
34
|
+
are not Lighthouse scores. If the environment provides Lighthouse, use its
|
|
35
|
+
own guidance and name the target. If it does not, report that limitation and
|
|
36
|
+
use only measurements that can actually run.
|
|
37
|
+
|
|
38
|
+
## 3. Pick the lens the question needs
|
|
39
|
+
|
|
40
|
+
| The user asks | Evidence to obtain |
|
|
41
|
+
| --------------------------------------------------------------- | --------------------------------------------- |
|
|
42
|
+
| Does the page render, is the copy right, is an image broken | browser snapshot and screenshot |
|
|
43
|
+
| Does this flow work, does the form submit, is the console clean | browser interaction and console output |
|
|
44
|
+
| Is it accessible, WCAG, contrast, labels, alt text | accessibility audit |
|
|
45
|
+
| Why does it feel slow, LCP, CLS, INP, TTFB, hydration | Web Vitals and, when needed, a profiler trace |
|
|
46
|
+
| Wrong data, a failing request, a slow API, response headers | network log, HAR, or HTTP response |
|
|
47
|
+
| Does the page expose its own tools to agents | WebMCP page tools, when supported |
|
|
48
|
+
| What is its Lighthouse score | an actual Lighthouse run |
|
|
49
|
+
|
|
50
|
+
Run only the lenses the question needs. Two lenses with clear evidence beat a
|
|
51
|
+
sweep of all seven.
|
|
52
|
+
|
|
53
|
+
## 4. Report honestly
|
|
54
|
+
|
|
55
|
+
- State the target URL and its kind (hosted preview, dev server, supplied URL),
|
|
56
|
+
the viewport, and when the checks ran.
|
|
57
|
+
- Give the observed values with their units and how many runs produced them.
|
|
58
|
+
One run is one run; say so.
|
|
59
|
+
- Keep what you observed separate from what you inferred, and list the lenses
|
|
60
|
+
you did not run.
|
|
61
|
+
- Never claim a check that did not run. If the environment blocked it (no
|
|
62
|
+
browser, an expired sandbox, a target that would not load), report what
|
|
63
|
+
blocked it.
|
|
64
|
+
|
|
65
|
+
For visitor behavior on the published site (pageviews, top pages, sources),
|
|
66
|
+
use `references/analytics.md`. It reports real traffic rather than one browser
|
|
67
|
+
run.
|
|
68
|
+
|
|
69
|
+
## See also
|
|
70
|
+
|
|
71
|
+
- `references/preview.md` for preview destinations and sandbox URL expiry.
|
|
72
|
+
- `references/deploy.md` for preview deployment and publishing authorization.
|
|
73
|
+
- `references/analytics.md` for published-site traffic.
|
package/dist/cli/bundle.json
CHANGED