fimo 2.8.0-staging.8 → 2.8.0

package/assets/agent-templates/content-translator/scripts/translate-entries.ts

@@ -1,69 +0,0 @@
-/**
- * Tool: translate-entries
- *
- * Walk every default-locale CMS entry, find missing non-default-locale
- * document rows, call the configured translation provider, and write back
- * through the Fimo API. Skips fields marked `translate: false` in the schema.
- *
- * Provider is configured via env (FIMO_AGENT_TRANSLATE_PROVIDER) — the
- * runtime threads project secrets through when the v1.x secrets API
- * lands. For now this template uses the OpenAI fallback.
- */
-
-interface Entry {
-  id: string;
-  documentId: string;
-  locale: string;
-  type: string;
-  data: Record<string, unknown>;
-}
-
-interface TranslateOptions {
-  fromLocale: string;
-  toLocales: string[];
-  api: { base: string; projectId: string; env: string };
-}
-
-async function listMissing(_opts: TranslateOptions): Promise<Entry[]> {
-  // Stub — wired to the Fimo API by the runtime. Returns entries with
-  // at least one missing target-locale document row while the default-locale
-  // row is populated.
-  return [];
-}
-
-async function translate(text: string, _to: string): Promise<string> {
-  // Stub — call the configured provider. Returns the translated string.
-  return text;
-}
-
-async function writeBack(_entry: Entry, _locale: string, _value: string): Promise<void> {
-  // Stub — create/update the target locale entry via
-  // `/api/tenant/:projectId/branches/:branch/entries/:type`.
-}
-
-async function main(): Promise<void> {
-  const fromLocale = process.env.FIMO_DEFAULT_LOCALE ?? 'en';
-  const toLocales = (process.env.FIMO_TARGET_LOCALES ?? '').split(',').filter(Boolean);
-  const api = {
-    base: process.env.FIMO_API_URL ?? 'http://localhost:3000',
-    projectId: process.env.FIMO_PROJECT_ID ?? '',
-    env: process.env.FIMO_ENV ?? 'main',
-  };
-
-  const entries = await listMissing({ fromLocale, toLocales, api });
-  for (const entry of entries) {
-    for (const locale of toLocales) {
-      const sourceValue = typeof entry.data.title === 'string' ? entry.data.title : undefined;
-      if (!sourceValue) {
-        continue;
-      }
-      const translated = await translate(sourceValue, locale);
-      await writeBack(entry, locale, translated);
-    }
-  }
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/assets/agent-templates/post-deploy-check/GOAL.md

@@ -1,23 +0,0 @@
-# Post-deploy check
-
-Run a quick health probe every time the project deploys, and post a
-summary back to the deploy log. Triggered automatically by the
-`deploy.succeeded` event.
-
-## What to do
-
-1. Read the routes the deploy declares as critical (`probe-routes.ts`).
-2. For each one, fetch and assert that the response is 2xx and renders
-   the expected key element (a known DOM selector).
-3. Read the last 5 minutes of production logs (`check-logs.ts`) and
-   surface any errors emitted during the deploy window.
-4. Write a single-line summary to stdout that the deploy notification
-   includes verbatim. Examples:
-   - `✅ 12 routes pass · 0 errors`
-   - `❌ /pricing failed (500) · 3 errors in last 5min`
-
-## What NOT to do
-
-- Don't roll back the deploy — that's a separate human-in-the-loop
-  decision; this agent only reports.
-- Don't write to CMS or files. Read-only probes plus log reads.

package/assets/agent-templates/post-deploy-check/capabilities.yaml

@@ -1 +0,0 @@
-- fimo:logs:read

package/assets/agent-templates/post-deploy-check/config.yaml

@@ -1,10 +0,0 @@
-version: 1
-description: 'Probe routes and inspect logs after a deploy; report any issues to email recipients.'
-model: openai/gpt-5.6-luna
-data_sources:
-  - prod
-
-triggers:
-  - type: manual
-  - type: webhook
-    path: deploy-done

package/assets/agent-templates/post-deploy-check/scripts/check-logs.ts

@@ -1,39 +0,0 @@
-/**
- * Tool: check-logs
- *
- * Query the project's production log stream for the last N minutes and
- * count errors. Used by the post-deploy-check summary line.
- *
- * Inputs (argv):
- *   1. Minutes to look back (default 5)
- *
- * Outputs (stdout JSON): { errors: number; first?: { ts: string; message: string } }
- */
-
-async function main(): Promise<void> {
-  const minutes = Number(process.argv[2] ?? '5');
-  const projectId = process.env.FIMO_PROJECT_ID ?? '';
-  const env = process.env.FIMO_ENV ?? 'main';
-  const base = process.env.FIMO_API_URL ?? 'http://localhost:3000';
-
-  const since = new Date(Date.now() - minutes * 60_000).toISOString();
-  const url = `${base}/api/management/projects/${projectId}/branches/${encodeURIComponent(env)}/logs?since=${encodeURIComponent(since)}&level=error`;
-
-  try {
-    const res = await fetch(url, { credentials: 'include' });
-    if (!res.ok) {
-      process.stdout.write(JSON.stringify({ errors: 0, note: `log endpoint returned ${res.status}` }));
-      return;
-    }
-    const payload = (await res.json()) as { data?: { entries?: Array<{ ts: string; message: string }> } };
-    const entries = payload.data?.entries ?? [];
-    process.stdout.write(JSON.stringify({ errors: entries.length, first: entries[0] }));
-  } catch (err) {
-    process.stdout.write(JSON.stringify({ errors: 0, note: `log fetch failed: ${(err as Error).message}` }));
-  }
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/assets/agent-templates/post-deploy-check/scripts/probe-routes.ts

@@ -1,53 +0,0 @@
-/**
- * Tool: probe-routes
- *
- * Fetch a list of critical routes and assert that each one responds
- * with a 2xx. Optionally checks that a known selector is present.
- *
- * Inputs (argv): JSON array of `{ url, selector? }`
- * Outputs (stdout JSON): { ok: number; failed: { url: string; status: number; reason: string }[] }
- */
-
-interface Probe {
-  url: string;
-  selector?: string;
-}
-
-interface Result {
-  ok: number;
-  failed: { url: string; status: number; reason: string }[];
-}
-
-async function probe(p: Probe): Promise<{ url: string; status: number; reason: string } | null> {
-  const res = await fetch(p.url, { redirect: 'manual' });
-  if (res.status < 200 || res.status >= 300) {
-    return { url: p.url, status: res.status, reason: `non-2xx status ${res.status}` };
-  }
-  if (p.selector) {
-    const body = await res.text();
-    if (!body.includes(p.selector)) {
-      return { url: p.url, status: res.status, reason: `expected selector "${p.selector}" not found` };
-    }
-  }
-  return null;
-}
-
-async function main(): Promise<void> {
-  const raw = process.argv[2] ?? '[]';
-  const probes = JSON.parse(raw) as Probe[];
-  const result: Result = { ok: 0, failed: [] };
-  for (const p of probes) {
-    const failure = await probe(p);
-    if (failure) {
-      result.failed.push(failure);
-    } else {
-      result.ok += 1;
-    }
-  }
-  process.stdout.write(JSON.stringify(result));
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/assets/agent-templates/seo-audit/GOAL.md

@@ -1,43 +0,0 @@
-# SEO audit
-
-Audit the project's pages for SEO health and deliver the findings as your session report.
-
-## Inputs
-
-- The project's published routes (via `scripts/list-routes.ts`)
-- Each page's HTML + response headers (via `scripts/fetch-page.ts`)
-- The current analytics data (read-only, via `fimo:analytics:read`)
-
-## What to check (per page)
-
-1. **Title tag** — present, 30–60 chars, unique across routes
-2. **Meta description** — present, 50–160 chars, unique
-3. **Open Graph** — `og:title`, `og:description`, `og:image`, `og:url`
-4. **Schema.org** — at minimum `WebPage`; `Article` on blog posts;
-   `BreadcrumbList` on nested routes
-5. **Headings** — exactly one `h1`; `h2`/`h3` nest correctly
-6. **Canonical URL** — `<link rel="canonical">` present and self-referential
-7. **Robots / X-Robots-Tag** — not `noindex` on routes that should be indexed
-8. **Sitemap** — every route is present in `/sitemap.xml`
-
-## What to produce
-
-Deliver the audit as your final session report — Fimo renders your last
-message as the report, so you do not have (and do not need) write access.
-Structure it as:
-
-- An executive summary (score / 100, top 3 issues)
-- A per-page table with status chips (✅ / ⚠️ / ❌)
-- A "fix recipes" appendix linking each failure to the smallest change
-  that would resolve it
-- A diff-friendly machine-readable footer (`<!-- agent-summary: ... -->`)
-  so subsequent runs can show the trend
-
-## What NOT to do
-
-- This audit is strictly read-only. Don't attempt to write files, create a
-  report file, or commit — and don't mention capabilities or write access in
-  the report itself. The report is your final message, nothing more.
-- Don't fetch external URLs other than the project's own domain.
-- Don't include traffic / conversion data in the report — it lives
-  elsewhere in the Fimo dashboard.

package/assets/agent-templates/seo-audit/capabilities.yaml

@@ -1,3 +0,0 @@
-# Read-only audit — no writes to project files or CMS.
-- cms:read
-- fimo:analytics:read

package/assets/agent-templates/seo-audit/config.yaml

@@ -1,14 +0,0 @@
-version: 1
-description: "Audit the project's pages for SEO health and write a markdown report."
-model: openai/gpt-5.6-luna
-# Read from main env. Switch to prod when running the audit against the
-# live site (M13 keeps data_sources here so M16's sandbox adapter can
-# bind the right Fimo API base URL).
-data_sources:
-  - main
-
-# Manual-only in v1. Add a schedule trigger when you're ready to run
-# this nightly — make sure .fimo/config.json has
-# `agents.notifications.email_recipients` set before activating.
-triggers:
-  - type: manual

package/assets/agent-templates/seo-audit/references/report-template.md

@@ -1,28 +0,0 @@
-# Report template
-
-The agent renders `reports/seo-audit-<YYYY-MM-DD>.md` using the shape:
-
-```markdown
-# SEO audit · 2026-05-26
-
-**Overall score:** 78 / 100
-
-## Per-page summary
-
-| Path     | Score | Status |
-| -------- | ----- | ------ |
-| `/`      | 95    | OK     |
-| `/about` | 70    | WARN   |
-
-## Findings
-
-### `/about`
-
-- ⚠️ **title-length** — Title length 22 chars — recommend 30–60
-- ❌ **h1-present** — No <h1> on the page
-
-<!-- agent-summary: { "score": 78, "pages": 12 } -->
-```
-
-The `<!-- agent-summary -->` comment is parsed by subsequent runs to
-plot a trend; keep its shape stable.

package/assets/agent-templates/seo-audit/references/scoring-methodology.md

@@ -1,30 +0,0 @@
-# Scoring methodology
-
-A page starts at 100 points and loses:
-
-- **-15** per `fail` finding (missing title, missing `<h1>`, `noindex` on a public page, etc.)
-- **-5** per `warn` finding (length out of range, missing OG tag, no canonical, etc.)
-
-The overall project score is the arithmetic mean of per-page scores.
-
-## Severity guide
-
-| Rule             | Severity  | Why                                                                  |
-| ---------------- | --------- | -------------------------------------------------------------------- |
-| title-present    | fail      | Without a title, search snippets fall back to the URL — costly       |
-| title-length     | warn      | Outside 30–60 chars, Google truncates or pads — still ranks          |
-| description-\*   | warn/fail | Less impact on rank but huge impact on CTR                           |
-| og-{title,image} | warn      | Affects social shares only; no SEO rank impact                       |
-| h1-present       | fail      | Page has no semantic root — both screen-readers and search hurt      |
-| h1-single        | warn      | Multiple h1s — accessibility lint, not a ranking penalty             |
-| canonical        | warn      | Self-referential canonical is best practice; rarely required         |
-| robots-noindex   | fail      | Page explicitly excluded from index — review and remove if a mistake |
-| schema-org       | warn      | Missing rich-result eligibility — won't hurt rank but loses CTR      |
-
-## How the agent should act on findings
-
-Don't write to project files in v1. Instead, the report's "fix recipes"
-appendix should link to the file the agent suspects is responsible (e.g.
-"fix this in `src/routes/[slug].tsx`'s `meta` export"). A follow-up
-agent — the one that resolves recipes into actual PRs — is the
-appropriate writer.

package/assets/agent-templates/seo-audit/scripts/analyze-html.ts

@@ -1,82 +0,0 @@
-/**
- * Tool: analyze-html
- *
- * Extract SEO signals from HTML — title, meta description, OG tags,
- * schema.org JSON-LD, heading structure, canonical, robots directive.
- * Returns a structured shape `score.ts` consumes.
- *
- * Inputs (stdin): HTML body
- * Outputs (stdout JSON): SEOSignals
- */
-
-interface SEOSignals {
-  title: string | null;
-  description: string | null;
-  canonical: string | null;
-  robots: string | null;
-  openGraph: Record<string, string>;
-  schemaOrg: unknown[];
-  headings: { h1: string[]; h2: string[]; h3: string[] };
-}
-
-function getMatch(html: string, regex: RegExp): string | null {
-  const m = html.match(regex);
-  return m && m[1] ? m[1].trim() : null;
-}
-
-function getAllMatches(html: string, regex: RegExp): string[] {
-  const out: string[] = [];
-  for (const m of html.matchAll(regex)) {
-    if (m[1]) {
-      out.push(m[1].trim());
-    }
-  }
-  return out;
-}
-
-async function readStdin(): Promise<string> {
-  const chunks: Buffer[] = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(Buffer.from(chunk));
-  }
-  return Buffer.concat(chunks).toString('utf8');
-}
-
-async function main(): Promise<void> {
-  const html = await readStdin();
-
-  const openGraph: Record<string, string> = {};
-  for (const m of html.matchAll(/<meta\s+property=["']og:([^"']+)["']\s+content=["']([^"']*)["']/gi)) {
-    openGraph[m[1]!] = m[2] ?? '';
-  }
-
-  const schemaOrg: unknown[] = [];
-  for (const m of html.matchAll(/<script\s+type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi)) {
-    try {
-      schemaOrg.push(JSON.parse(m[1]!.trim()));
-    } catch {
-      // skip invalid JSON-LD blocks
-    }
-  }
-
-  const signals: SEOSignals = {
-    title: getMatch(html, /<title>([\s\S]*?)<\/title>/i),
-    description: getMatch(html, /<meta\s+name=["']description["']\s+content=["']([^"']*)["']/i),
-    canonical: getMatch(html, /<link\s+rel=["']canonical["']\s+href=["']([^"']*)["']/i),
-    robots: getMatch(html, /<meta\s+name=["']robots["']\s+content=["']([^"']*)["']/i),
-    openGraph,
-    schemaOrg,
-    headings: {
-      h1: getAllMatches(html, /<h1[^>]*>([\s\S]*?)<\/h1>/gi).map((s) => s.replace(/<[^>]+>/g, '').trim()),
-      h2: getAllMatches(html, /<h2[^>]*>([\s\S]*?)<\/h2>/gi).map((s) => s.replace(/<[^>]+>/g, '').trim()),
-      h3: getAllMatches(html, /<h3[^>]*>([\s\S]*?)<\/h3>/gi).map((s) => s.replace(/<[^>]+>/g, '').trim()),
-    },
-  };
-
-  process.stdout.write(JSON.stringify(signals, null, 2));
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/assets/agent-templates/seo-audit/scripts/fetch-page.ts

@@ -1,39 +0,0 @@
-/**
- * Tool: fetch-page
- *
- * Fetch HTML + headers for a given URL. Used by the audit to walk every
- * route returned by `list-routes` and feed the bytes to `analyze-html`.
- *
- * Inputs (argv):
- *   1. The URL to fetch (must be the project's own domain)
- *
- * Outputs (stdout JSON):
- *   {
- *     "url": "...",
- *     "status": 200,
- *     "headers": { "content-type": "text/html; charset=utf-8", ... },
- *     "body": "<!doctype html>..."
- *   }
- */
-
-async function main(): Promise<void> {
-  const url = process.argv[2];
-  if (!url) {
-    console.error('Usage: fetch-page <url>');
-    process.exit(1);
-  }
-
-  const res = await fetch(url, { redirect: 'manual' });
-  const headers: Record<string, string> = {};
-  res.headers.forEach((value, key) => {
-    headers[key] = value;
-  });
-
-  const body = await res.text();
-  process.stdout.write(JSON.stringify({ url, status: res.status, headers, body }, null, 2));
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/assets/agent-templates/seo-audit/scripts/list-routes.ts

@@ -1,46 +0,0 @@
-/**
- * Tool: list-routes
- *
- * Enumerate every public route in the project via the Fimo management
- * API. Returns paths the audit walks one-by-one through `fetch-page`.
- *
- * Inputs (branch):
- *   - FIMO_PROJECT_ID — provided by the runtime (M16 sandbox adapter)
- *   - FIMO_ENV        — provided by the runtime (legacy runtime selector)
- *   - FIMO_API_URL    — provided by the runtime
- *
- * Outputs (stdout JSON):
- *   { "routes": [{ "path": "/", "label": "Home" }, ...] }
- */
-
-interface Route {
-  path: string;
-  label: string;
-}
-
-async function main(): Promise<void> {
-  const projectId = process.env.FIMO_PROJECT_ID;
-  const env = process.env.FIMO_ENV ?? 'main';
-  const base = process.env.FIMO_API_URL ?? 'http://localhost:3000';
-
-  if (!projectId) {
-    console.error('FIMO_PROJECT_ID is required');
-    process.exit(1);
-  }
-
-  const url = `${base}/api/management/projects/${projectId}/branches/${encodeURIComponent(env)}/routes`;
-  const res = await fetch(url, { credentials: 'include' });
-  if (!res.ok) {
-    console.error(`Failed to list routes: ${res.status} ${res.statusText}`);
-    process.exit(1);
-  }
-
-  const payload = (await res.json()) as { data?: { routes?: Record<string, Route> } };
-  const routes = Object.values(payload.data?.routes ?? {});
-  process.stdout.write(JSON.stringify({ routes }, null, 2));
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/assets/agent-templates/seo-audit/scripts/report.ts

@@ -1,82 +0,0 @@
-/**
- * Tool: report
- *
- * Render a markdown report from the per-page audit results.
- *
- * Inputs (stdin JSON): { score: number, pages: PageReport[] }
- * Outputs (stdout): markdown
- */
-
-interface Finding {
-  rule: string;
-  severity: 'ok' | 'warn' | 'fail';
-  message: string;
-}
-
-interface PageReport {
-  path: string;
-  score: number;
-  findings: Finding[];
-}
-
-function statusChip(score: number): string {
-  if (score >= 80) {
-    return 'OK';
-  }
-  if (score >= 60) {
-    return 'WARN';
-  }
-  return 'FAIL';
-}
-
-async function readStdin(): Promise<string> {
-  const chunks: Buffer[] = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(Buffer.from(chunk));
-  }
-  return Buffer.concat(chunks).toString('utf8');
-}
-
-async function main(): Promise<void> {
-  const text = await readStdin();
-  const data = JSON.parse(text) as { score: number; pages: PageReport[] };
-
-  const date = new Date().toISOString().slice(0, 10);
-  const lines: string[] = [];
-  lines.push(`# SEO audit · ${date}`);
-  lines.push('');
-  lines.push(`**Overall score:** ${data.score} / 100`);
-  lines.push('');
-  lines.push('## Per-page summary');
-  lines.push('');
-  lines.push('| Path | Score | Status |');
-  lines.push('|------|-------|--------|');
-  for (const page of data.pages) {
-    lines.push(`| \`${page.path}\` | ${page.score} | ${statusChip(page.score)} |`);
-  }
-  lines.push('');
-  lines.push('## Findings');
-  lines.push('');
-  for (const page of data.pages) {
-    const failures = page.findings.filter((f) => f.severity !== 'ok');
-    if (failures.length === 0) {
-      continue;
-    }
-    lines.push(`### \`${page.path}\``);
-    lines.push('');
-    for (const finding of failures) {
-      const sev = finding.severity === 'fail' ? '❌' : '⚠️';
-      lines.push(`- ${sev} **${finding.rule}** — ${finding.message}`);
-    }
-    lines.push('');
-  }
-  lines.push('');
-  lines.push(`<!-- agent-summary: { "score": ${data.score}, "pages": ${data.pages.length} } -->`);
-
-  process.stdout.write(lines.join('\n'));
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});