fimo 2.8.0-staging.11 → 2.8.0-staging.13

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);
-});

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

@@ -1,131 +0,0 @@
-/**
- * Tool: score
- *
- * Apply the SEO scoring methodology (see references/scoring-methodology.md)
- * to a list of `(path, SEOSignals)` tuples and produce a per-page report.
- *
- * Inputs (stdin JSON): { signals: Record<path, SEOSignals> }
- * Outputs (stdout JSON): { score: 0..100, pages: PageReport[] }
- */
-
-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[] };
-}
-
-interface Finding {
-  rule: string;
-  severity: 'ok' | 'warn' | 'fail';
-  message: string;
-}
-
-interface PageReport {
-  path: string;
-  score: number;
-  findings: Finding[];
-}
-
-function audit(signals: SEOSignals): Finding[] {
-  const out: Finding[] = [];
-
-  // Title
-  if (!signals.title) {
-    out.push({ rule: 'title-present', severity: 'fail', message: 'Missing <title>' });
-  } else if (signals.title.length < 30 || signals.title.length > 60) {
-    out.push({
-      rule: 'title-length',
-      severity: 'warn',
-      message: `Title length ${signals.title.length} chars — recommend 30–60`,
-    });
-  } else {
-    out.push({ rule: 'title', severity: 'ok', message: 'Title looks good' });
-  }
-
-  // Description
-  if (!signals.description) {
-    out.push({ rule: 'description-present', severity: 'fail', message: 'Missing meta description' });
-  } else if (signals.description.length < 50 || signals.description.length > 160) {
-    out.push({
-      rule: 'description-length',
-      severity: 'warn',
-      message: `Description length ${signals.description.length} chars — recommend 50–160`,
-    });
-  }
-
-  // OG tags
-  for (const key of ['title', 'description', 'image', 'url']) {
-    if (!signals.openGraph[key]) {
-      out.push({ rule: `og-${key}`, severity: 'warn', message: `Missing og:${key}` });
-    }
-  }
-
-  // Headings
-  if (signals.headings.h1.length === 0) {
-    out.push({ rule: 'h1-present', severity: 'fail', message: 'No <h1> on the page' });
-  } else if (signals.headings.h1.length > 1) {
-    out.push({ rule: 'h1-single', severity: 'warn', message: `Multiple <h1> tags (${signals.headings.h1.length})` });
-  }
-
-  // Canonical
-  if (!signals.canonical) {
-    out.push({ rule: 'canonical', severity: 'warn', message: 'Missing canonical link' });
-  }
-
-  // Robots
-  if (signals.robots && /noindex/i.test(signals.robots)) {
-    out.push({ rule: 'robots-noindex', severity: 'fail', message: 'Page is marked noindex' });
-  }
-
-  // Schema.org
-  if (signals.schemaOrg.length === 0) {
-    out.push({ rule: 'schema-org', severity: 'warn', message: 'No JSON-LD schema.org block' });
-  }
-
-  return out;
-}
-
-function scoreOf(findings: Finding[]): number {
-  // Each fail = -15, each warn = -5. Floor at 0.
-  let pts = 100;
-  for (const f of findings) {
-    if (f.severity === 'fail') {
-      pts -= 15;
-    } else if (f.severity === 'warn') {
-      pts -= 5;
-    }
-  }
-  return Math.max(0, pts);
-}
-
-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 payload = JSON.parse(text) as { signals: Record<string, SEOSignals> };
-
-  const pages: PageReport[] = [];
-  for (const [path, signals] of Object.entries(payload.signals)) {
-    const findings = audit(signals);
-    pages.push({ path, score: scoreOf(findings), findings });
-  }
-
-  const overall = pages.length === 0 ? 0 : Math.round(pages.reduce((a, p) => a + p.score, 0) / pages.length);
-
-  process.stdout.write(JSON.stringify({ score: overall, pages }, null, 2));
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});