fimo 2.4.0-staging.7 → 2.4.0-staging.9

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.
@@ -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.
@@ -1,6 +1,6 @@
1
1
  # Agents
2
2
 
3
- Project agents are versioned bundles from the project's repository. Studio lets project members inspect their configuration and run history, while project managers can start, stop, and resume them.
3
+ Project agents are versioned bundles from the project's repository. Studio lets project members inspect their configuration and run history, while project managers can start, stop, resume, and delete them.
4
4
 
5
5
  ## Open an agent
6
6
 
@@ -20,6 +20,12 @@ A stopped agent shows **Paused** in the header. **Resume** makes the same trigge
20
20
 
21
21
  Only project managers see Run, Stop, and Resume. Other project members can still see schedule timing, status, settings, and run history.
22
22
 
23
+ ## Delete an agent
24
+
25
+ Project managers can open **Agent actions** beside Run/Stop, choose **Delete agent**, and confirm. Deletion stops planned or running work and commits removal of the agent bundle from `main`. Recorded runs remain in history. Remove the bundle from a local checkout before deploying again, or that deployment recreates the agent.
26
+
27
+ If a run cannot be stopped or `main` changes before deletion commits, the definition stays intact and the agent may remain paused. Reload and retry, or resume it if you want to keep it.
28
+
23
29
  ## Inspect runs
24
30
 
25
31
  Open **Runs** on an agent to see only that bundle's history. Select a run to read its status, report, captured changes, and any question or review state that needs attention.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "bundled": true,
3
3
  "bundler": "esbuild",
4
- "bundledAt": "2026-09-07T07:12:39.755Z",
4
+ "bundledAt": "2026-09-07T13:00:46.494Z",
5
5
  "cliVersion": "2.3.2",
6
6
  "external": [
7
7
  "oxc-parser",