fimo 2.2.0-staging.10 → 2.2.0-staging.12

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.
Files changed (45) hide show
  1. package/assets/skills/fimo-cli/SKILL.md +1 -1
  2. package/assets/skills/fimo-cli/references/assets.md +38 -2
  3. package/assets/skills/fimo-cli/references/content.md +1 -1
  4. package/assets/skills/fimo-code/references/content/schema.md +1 -0
  5. package/assets/skills/fimo-migration/SKILL.md +44 -13
  6. package/assets/skills/fimo-migration/references/frameworks/nextjs.md +8 -0
  7. package/assets/skills/fimo-migration/references/qa.md +30 -4
  8. package/assets/skills/fimo-migration/references/questions-and-improvements.md +188 -0
  9. package/assets/skills/fimo-migration/references/workers/content-planner.md +8 -3
  10. package/assets/skills/fimo-migration/references/workers/validator.md +20 -6
  11. package/assets/skills/fimo-migration/references/workers.md +17 -6
  12. package/assets/skills/fimo-migration/references/workflow.md +33 -6
  13. package/assets/skills/fimo-studio/SKILL.md +3 -1
  14. package/assets/skills/fimo-studio/references/agents.md +25 -0
  15. package/dist/cli/bundle.json +1 -1
  16. package/dist/cli/index.js +12 -11
  17. package/dist/runtime/templates.d.ts +1 -0
  18. package/dist/runtime/templates.js +3 -0
  19. package/dist/scripts/validate-schemas.js +10 -15
  20. package/package.json +8 -7
  21. package/templates/astro/package.json +2 -2
  22. package/templates/nextjs/package.json +3 -3
  23. package/templates/react-router/package.json +4 -4
  24. package/templates/sveltekit/package.json +2 -2
  25. package/templates/vite/package.json +4 -4
  26. package/templates/welcome/manifest.json +404 -0
  27. package/templates/welcome/media/analytics-overview.avif +0 -0
  28. package/templates/welcome/media/autonomous-loop.avif +0 -0
  29. package/templates/welcome/media/editable-preview.avif +0 -0
  30. package/templates/welcome/media/media-library.avif +0 -0
  31. package/templates/welcome/media/slack-teams.avif +0 -0
  32. package/templates/welcome/template/.fimo/agents/welcome-guide/GOAL.md +7 -0
  33. package/templates/welcome/template/.fimo/agents/welcome-guide/config.yaml +8 -0
  34. package/templates/welcome/template/.fimo/config.json +53 -0
  35. package/templates/welcome/template/src/font.css +60 -0
  36. package/templates/welcome/template/src/pages/ArticleDetail.tsx +68 -0
  37. package/templates/welcome/template/src/pages/Index.tsx +32 -0
  38. package/templates/welcome/template/src/pages/SiteContent.tsx +413 -0
  39. package/templates/welcome/template/src/pages/fallback-content.ts +133 -0
  40. package/templates/welcome/template/src/routes.ts +9 -0
  41. package/templates/welcome/template/src/schemas/Article.json +12 -0
  42. package/templates/welcome/template/src/schemas/Article.ts +59 -0
  43. package/templates/welcome/template/src/schemas/Article.types.ts +73 -0
  44. package/templates/welcome/template/src/schemas/HomePage.json +39 -0
  45. package/templates/welcome/template/src/schemas/HomePage.types.ts +114 -0
@@ -4,6 +4,15 @@ Use this as the phase contract for a complete migration. The coordinator and
4
4
  workers communicate in plain text. JSON is used only for Fimo schemas and the
5
5
  content payloads that the data-plane commands import.
6
6
 
7
+ ## Preflight: inspect and ask
8
+
9
+ Before target initialization or any other write, inspect the source read-only
10
+ and follow `references/questions-and-improvements.md`. Use the coding agent's
11
+ native structured-question UI to ask one stacked batch for integration,
12
+ environment, framework, and ownership decisions that the source cannot settle.
13
+ Never move environment values or credentials without explicit consent. Do not
14
+ ask a generic optimization question.
15
+
7
16
  ## Phase 0: Initialize the target
8
17
 
9
18
  1. Confirm the target path. The target is a separate directory; the source
@@ -20,9 +29,15 @@ content payloads that the data-plane commands import.
20
29
  3. Inspect the target's real `package.json`, `.fimo/config.json`, framework config, and route
21
30
  directories. They are the authority for paths. Do not infer an app root
22
31
  from a skill example and do not create a second `app/` or `src/app/` tree.
23
- 4. If the target is non-empty and not a Fimo project, stop and ask for a target
32
+ 4. Verify dependency provenance before workers start. A project created by a
33
+ published CLI pins that exact CLI release and matching companion packages.
34
+ A local source-checkout project uses the checkout-local CLI. Stop when the
35
+ target records an absolute package-manager cache path, an unapproved
36
+ `latest`, or a CLI and API from different runtime channels; do not let the
37
+ producer repair release setup inside the migration.
38
+ 5. If the target is non-empty and not a Fimo project, stop and ask for a target
24
39
  path; do not overlay a template on top of it.
25
- 5. Keep source material in `.fimo/migration/source` or another explicit source
40
+ 6. Keep source material in `.fimo/migration/source` or another explicit source
26
41
  location. Do not copy source files over the initialized target root.
27
42
 
28
43
  Write a short `.fimo/migration/migration-plan.md` containing the source
@@ -46,8 +61,10 @@ Classify the available evidence:
46
61
  For private APIs or CMSs, ask for a user-provided export or a narrowly scoped
47
62
  server-side credential. Never recover credentials from browser bundles or copy
48
63
  them into migration artifacts. If the source API URL or access is missing or
49
- unreachable, stop and ask the user for it; do not guess or continue with
50
- replacement content.
64
+ unreachable, stop and ask whether to use scoped access, reconstruct only the
65
+ selected published routes from the public site, or migrate code without the CMS
66
+ records. Continue with public reconstruction only after that explicit choice,
67
+ and record everything the rendered site cannot reveal.
51
68
 
52
69
  For API-backed content, trace active clients, endpoints, frontend types, and
53
70
  consumers first. Prefer backend source schemas; otherwise use public OpenAPI,
@@ -143,12 +160,22 @@ one generic static shell. Apply the matching framework reference before
143
160
  disposing of provider-specific rules; redirects, headers, feeds, metadata,
144
161
  forms, and freshness behavior are observable contracts.
145
162
 
163
+ When local or bundled content becomes Fimo-backed, follow the content-delivery
164
+ contract in `references/questions-and-improvements.md`. Preserve build-time or
165
+ server rendering, direct lookups, bounded reads, request parallelism, and edit
166
+ freshness. A new browser waterfall, repeated full-list read, avoidable
167
+ sequential request chain, or stale edit is a migration regression.
168
+
146
169
  ## Phase 6: Fan in, validate, and report
147
170
 
148
171
  Workers return the plain-text receipt defined in `references/workers.md`.
149
172
  The coordinator checks those claims against the diff, source, CLI read-back,
150
- build, and rendered routes. Then an independent worker follows
151
- `references/workers/validator.md`; a worker saying "done" is not evidence.
173
+ build, and rendered routes. Then it runs the read-only validation wave from
174
+ `references/workers/validator.md`, passing the accepted scope and deliberate
175
+ user-approved differences as task context; a worker saying "done" is not
176
+ evidence.
177
+ Collect the complete finding set before assigning repairs. Run disjoint repair
178
+ owners together, wait for all repairs, and rerun one central validation wave.
152
179
 
153
180
  Write `.fimo/migration/migration-report.md` with route/content/media/form/SEO
154
181
  coverage, import counts, worker timings, unresolved items, and next actions.
@@ -6,7 +6,7 @@ description: >-
6
6
  Triggers: "in Fimo Studio", "in the dashboard", "in the web app",
7
7
  "how do I X in the UI", or screenshots of the dashboard. Topics
8
8
  covered: dashboard content and CMS, publishing from the dashboard,
9
- dashboard SEO/domain settings, project connections, schedules and run history, outbound webhooks,
9
+ dashboard SEO/domain settings, project connections, agents, schedules and run history, outbound webhooks,
10
10
  visual editing, version history UI, dashboard sharing/billing, dashboard chat,
11
11
  and the command palette. Never describe
12
12
  UI locations, buttons, or panels from memory — always read the relevant
@@ -39,6 +39,7 @@ Read the relevant reference file when the user's question matches a topic.
39
39
  | AI Chat | references/ai-chat.md | "What can the AI do?", "How do I give context?" |
40
40
  | Code Editor | references/code-editor.md | "How do I edit code?", "Where are my files?" |
41
41
  | SEO Settings | references/seo-settings.md | "How do I set up SEO?", "Favicon, title, share image" |
42
+ | Agents | references/agents.md | "Run an agent", "Pause an agent", "Next agent run" |
42
43
  | Schedules | references/schedules.md | "Recurring commands", "Run history", "Run now" |
43
44
  | Webhooks | references/webhooks.md | "React to forms", "Send events to another service" |
44
45
  | Connections | references/connections.md | "Connect a service", "Add an MCP server" |
@@ -60,6 +61,7 @@ Read the relevant reference file when the user's question matches a topic.
60
61
  | Content/CMS | AI Chat, Media Library |
61
62
  | Webhooks | Project secrets, Forms, Publishing, Agents |
62
63
  | Connections | AI Chat, Agents, Project secrets |
64
+ | Agents | Connections, Project secrets, Branches |
63
65
  | Schedules | Project secrets, Environments, Agents |
64
66
  | Visual changes | Edit Mode (quick tweaks), AI Chat (bigger changes), Code Editor (full control) |
65
67
  | Something went wrong | Version History, AI Chat |
@@ -0,0 +1,25 @@
1
+ # Agents
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.
4
+
5
+ ## Open an agent
6
+
7
+ 1. Open the project and choose **Agents**.
8
+ 2. Select **Agents** again to see the available bundles.
9
+ 3. Choose an agent to open its **Runs** and **Settings** tabs.
10
+
11
+ When the agent has a live schedule, its next run appears first in **Runs**, marked **Scheduled**. The row uses **Next** for its projected ID, a relative date such as **Tomorrow at 11:00 AM**, and **—** for changes and duration until it starts. **Settings** shows the bundle's declared capabilities and trigger wiring; it is read-only because the repository remains the source of truth.
12
+
13
+ ## Run, stop, or resume
14
+
15
+ Choose **Run** to start an agent whose manual trigger is live.
16
+
17
+ Choose **Stop** to pause every future trigger and stop planned or running work. Studio asks for confirmation and explains that the bundle, trigger configuration, model, capabilities, and other settings are preserved.
18
+
19
+ A stopped agent shows **Paused** in the header. **Resume** makes the same triggers live again with their previous settings.
20
+
21
+ Only project managers see Run, Stop, and Resume. Other project members can still see schedule timing, status, settings, and run history.
22
+
23
+ ## Inspect runs
24
+
25
+ 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-08-28T09:18:13.313Z",
4
+ "bundledAt": "2026-08-28T14:46:45.101Z",
5
5
  "cliVersion": "2.1.0",
6
6
  "external": [
7
7
  "oxc-parser",