fimo 2.2.0-staging.10 → 2.2.0-staging.11
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 -1
- package/assets/skills/fimo-cli/references/assets.md +38 -2
- package/assets/skills/fimo-migration/SKILL.md +44 -13
- package/assets/skills/fimo-migration/references/frameworks/nextjs.md +8 -0
- package/assets/skills/fimo-migration/references/qa.md +30 -4
- package/assets/skills/fimo-migration/references/questions-and-improvements.md +188 -0
- package/assets/skills/fimo-migration/references/workers/content-planner.md +8 -3
- package/assets/skills/fimo-migration/references/workers/validator.md +20 -6
- package/assets/skills/fimo-migration/references/workers.md +17 -6
- package/assets/skills/fimo-migration/references/workflow.md +33 -6
- package/assets/skills/fimo-studio/SKILL.md +3 -1
- package/assets/skills/fimo-studio/references/agents.md +25 -0
- package/dist/cli/bundle.json +1 -1
- package/dist/cli/index.js +12 -11
- package/dist/runtime/templates.d.ts +1 -0
- package/dist/runtime/templates.js +3 -0
- package/package.json +8 -7
- 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
- package/templates/welcome/manifest.json +404 -0
- package/templates/welcome/media/analytics-overview.avif +0 -0
- package/templates/welcome/media/autonomous-loop.avif +0 -0
- package/templates/welcome/media/editable-preview.avif +0 -0
- package/templates/welcome/media/media-library.avif +0 -0
- package/templates/welcome/media/slack-teams.avif +0 -0
- package/templates/welcome/template/.fimo/agents/welcome-guide/GOAL.md +7 -0
- package/templates/welcome/template/.fimo/agents/welcome-guide/config.yaml +8 -0
- package/templates/welcome/template/.fimo/config.json +53 -0
- package/templates/welcome/template/src/font.css +60 -0
- package/templates/welcome/template/src/pages/ArticleDetail.tsx +68 -0
- package/templates/welcome/template/src/pages/Index.tsx +32 -0
- package/templates/welcome/template/src/pages/SiteContent.tsx +413 -0
- package/templates/welcome/template/src/pages/fallback-content.ts +133 -0
- package/templates/welcome/template/src/routes.ts +9 -0
- package/templates/welcome/template/src/schemas/Article.json +12 -0
- package/templates/welcome/template/src/schemas/Article.ts +59 -0
- package/templates/welcome/template/src/schemas/Article.types.ts +73 -0
- package/templates/welcome/template/src/schemas/HomePage.json +39 -0
- 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.
|
|
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
|
-
|
|
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
|
|
50
|
-
|
|
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
|
|
151
|
-
`references/workers/validator.md
|
|
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.
|