seo 0.13.2 → 0.14.0

package/site-kit/starter/src/styles/globals.css

@@ -0,0 +1,561 @@
+@import "tailwindcss" source("..");
+
+/* The whole theme lives in this file. Inter for text, JetBrains Mono for
+   code, neutral oklch surfaces, one accent colour, soft muted panels
+   instead of borders and shadows, and automatic light and dark mode.
+   Pages and components use the token classes (bg-muted, text-foreground,
+   text-primary) and never a raw colour, so changing a value here restyles
+   the whole site. `seo site check` fails on raw colours and <style> blocks
+   anywhere else. */
+
+/* Latin subsets of the variable fonts. The sharing images use the same
+   files. For a language with other letters, swap in the full fonts. */
+@font-face {
+  font-family: "InterVariable";
+  src: url("/fonts/InterLatinVF.woff2") format("woff2");
+  font-display: swap;
+  font-style: normal;
+  font-weight: 100 900;
+}
+
+/* Arial scaled to Inter's width and line metrics, so text does not move
+   when Inter arrives after the first paint. */
+@font-face {
+  font-family: "Inter fallback";
+  src: local("Arial"), local("ArialMT");
+  size-adjust: 107.12%;
+  ascent-override: 90.44%;
+  descent-override: 22.52%;
+  line-gap-override: 0%;
+}
+
+@font-face {
+  font-family: "JetBrains Mono";
+  src: url("/fonts/JetBrainsMonoLatinVF.woff2") format("woff2");
+  font-display: swap;
+  font-style: normal;
+  font-weight: 100 800;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-background-raised: var(--background-raised);
+  --color-background-subtle: var(--background-subtle);
+  --color-foreground: var(--foreground);
+  --color-foreground-muted: var(--foreground-muted);
+  --color-foreground-soft: var(--foreground-soft);
+  --color-border: var(--border);
+  --color-border-subtle: var(--border-subtle);
+  --color-border-strong: var(--border-strong);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-soft: var(--primary-soft);
+  --color-primary-hover: var(--primary-hover);
+  --color-primary-active: var(--primary-active);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-soft: var(--secondary-soft);
+  --color-secondary-hover: var(--secondary-hover);
+  --color-secondary-active: var(--secondary-active);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-soft: var(--destructive-soft);
+  --color-destructive-hover: var(--destructive-hover);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-success: var(--success);
+  --color-success-soft: var(--success-soft);
+  --color-warning: var(--warning);
+  --color-warning-soft: var(--warning-soft);
+  --color-warning-foreground: var(--warning-foreground);
+  --color-info: var(--info);
+  --color-info-soft: var(--info-soft);
+  --color-overlay-scrim: var(--overlay-scrim);
+  --radius-xs: calc(var(--radius) - 6px);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 2px);
+  --radius-2xl: calc(var(--radius) + 4px);
+  --font-sans:
+    "InterVariable", "Inter fallback", ui-sans-serif, system-ui, sans-serif;
+  --font-mono:
+    "JetBrains Mono", ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas,
+    monospace;
+}
+
+:root {
+  color-scheme: light;
+  --radius: 0.625rem;
+
+  /* One value sets the page frame for every page, header and footer. */
+  --frame-max: 48rem;
+
+  --background: oklch(98.5% 0 0);
+  --background-raised: oklch(100% 0 0);
+  --background-subtle: oklch(96% 0 0);
+  --foreground: oklch(20.5% 0 0);
+  --foreground-muted: oklch(45% 0 0);
+  --foreground-soft: oklch(60% 0 0);
+  --border: oklch(92% 0 0);
+  --border-subtle: oklch(95% 0 0);
+  --border-strong: oklch(85% 0 0);
+  --input: oklch(92% 0 0);
+  --ring: oklch(54% 0.24 262);
+
+  --card: oklch(100% 0 0);
+  --card-foreground: var(--foreground);
+  --popover: oklch(100% 0 0);
+  --popover-foreground: var(--foreground);
+
+  --primary: oklch(54% 0.24 262);
+  --primary-soft: oklch(95% 0.035 262);
+  --primary-hover: oklch(48% 0.24 262);
+  --primary-active: oklch(43% 0.22 262);
+  --primary-foreground: oklch(98.5% 0 0);
+
+  --secondary: oklch(96% 0 0);
+  --secondary-soft: oklch(98% 0 0);
+  --secondary-hover: oklch(92% 0 0);
+  --secondary-active: oklch(88% 0 0);
+  --secondary-foreground: var(--foreground);
+
+  --muted: oklch(96% 0 0);
+  --muted-foreground: oklch(45% 0 0);
+  --accent: oklch(96% 0 0);
+  --accent-foreground: var(--foreground);
+
+  --destructive: oklch(57% 0.22 27);
+  --destructive-soft: oklch(95% 0.05 27);
+  --destructive-hover: oklch(50% 0.22 27);
+  --destructive-foreground: oklch(98.5% 0 0);
+
+  --success: oklch(60% 0.16 145);
+  --success-soft: oklch(95% 0.04 145);
+  --warning: oklch(75% 0.16 80);
+  --warning-soft: oklch(95% 0.05 80);
+  --warning-foreground: oklch(30% 0.06 80);
+  --info: oklch(60% 0.13 240);
+  --info-soft: oklch(95% 0.04 240);
+
+  --overlay-scrim: oklch(0% 0 0 / 0.5);
+}
+
+/* Dark mode follows the system unless a page sets data-theme on <html>. */
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) {
+    color-scheme: dark;
+    --background: oklch(20.5% 0 0);
+    --background-raised: oklch(24% 0 0);
+    --background-subtle: oklch(17% 0 0);
+    --foreground: oklch(98.5% 0 0);
+    --foreground-muted: oklch(72% 0 0);
+    --foreground-soft: oklch(55% 0 0);
+    --border: oklch(28% 0 0);
+    --border-subtle: oklch(24% 0 0);
+    --border-strong: oklch(38% 0 0);
+    --input: oklch(28% 0 0);
+    --ring: oklch(78.9% 0.154 211.53);
+
+    --card: oklch(24% 0 0);
+    --popover: oklch(24% 0 0);
+
+    --primary: oklch(78.9% 0.154 211.53);
+    --primary-soft: oklch(30% 0.07 211.53);
+    --primary-hover: oklch(72% 0.16 211.53);
+    --primary-active: oklch(65% 0.17 211.53);
+    --primary-foreground: oklch(15% 0.05 211.53);
+
+    --secondary: oklch(28% 0 0);
+    --secondary-soft: oklch(24% 0 0);
+    --secondary-hover: oklch(34% 0 0);
+    --secondary-active: oklch(40% 0 0);
+
+    --muted: oklch(28% 0 0);
+    --accent: oklch(28% 0 0);
+
+    --destructive: oklch(65% 0.22 27);
+    --destructive-soft: oklch(30% 0.1 27);
+    --destructive-hover: oklch(58% 0.22 27);
+
+    --success: oklch(70% 0.16 145);
+    --success-soft: oklch(28% 0.07 145);
+    --warning: oklch(80% 0.16 80);
+    --warning-soft: oklch(30% 0.08 80);
+    --info: oklch(72% 0.13 240);
+    --info-soft: oklch(28% 0.07 240);
+  }
+}
+
+:root[data-theme="dark"] {
+  color-scheme: dark;
+  --background: oklch(20.5% 0 0);
+  --background-raised: oklch(24% 0 0);
+  --background-subtle: oklch(17% 0 0);
+  --foreground: oklch(98.5% 0 0);
+  --foreground-muted: oklch(72% 0 0);
+  --foreground-soft: oklch(55% 0 0);
+  --border: oklch(28% 0 0);
+  --border-subtle: oklch(24% 0 0);
+  --border-strong: oklch(38% 0 0);
+  --input: oklch(28% 0 0);
+  --ring: oklch(78.9% 0.154 211.53);
+
+  --card: oklch(24% 0 0);
+  --popover: oklch(24% 0 0);
+
+  --primary: oklch(78.9% 0.154 211.53);
+  --primary-soft: oklch(30% 0.07 211.53);
+  --primary-hover: oklch(72% 0.16 211.53);
+  --primary-active: oklch(65% 0.17 211.53);
+  --primary-foreground: oklch(15% 0.05 211.53);
+
+  --secondary: oklch(28% 0 0);
+  --secondary-soft: oklch(24% 0 0);
+  --secondary-hover: oklch(34% 0 0);
+  --secondary-active: oklch(40% 0 0);
+
+  --muted: oklch(28% 0 0);
+  --accent: oklch(28% 0 0);
+
+  --destructive: oklch(65% 0.22 27);
+  --destructive-soft: oklch(30% 0.1 27);
+  --destructive-hover: oklch(58% 0.22 27);
+
+  --success: oklch(70% 0.16 145);
+  --success-soft: oklch(28% 0.07 145);
+  --warning: oklch(80% 0.16 80);
+  --warning-soft: oklch(30% 0.08 80);
+  --info: oklch(72% 0.13 240);
+  --info-soft: oklch(28% 0.07 240);
+}
+
+@layer base {
+  body {
+    font-size: 0.9375rem;
+    line-height: 1.5;
+  }
+
+  h1,
+  h2,
+  h3,
+  h4,
+  h5,
+  h6 {
+    font-weight: 550;
+    letter-spacing: 0;
+    font-variation-settings: "opsz" 32;
+  }
+
+  code,
+  pre {
+    font-family:
+      "JetBrains Mono", ui-monospace, SFMono-Regular, "SF Mono", Menlo,
+      Consolas, monospace;
+  }
+
+  button:not(:disabled),
+  [role="button"] {
+    cursor: pointer;
+  }
+
+  /* Inputs show exactly what was typed, with no ligatures. */
+  input,
+  textarea {
+    font-variant-ligatures: none;
+    font-feature-settings: "liga" 0, "clig" 0, "calt" 0;
+  }
+
+  .site-prose > :first-child {
+    margin-top: 0;
+  }
+
+  .site-prose > h1 {
+    margin-bottom: 1.5rem;
+    color: var(--foreground);
+    font-weight: 500;
+    font-size: 1.875rem;
+    line-height: 2.25rem;
+    text-wrap: pretty;
+  }
+
+  .site-prose > h2 {
+    margin-top: 3rem;
+    color: var(--foreground);
+    font-weight: 500;
+    font-size: 1.25rem;
+    line-height: 1.75rem;
+    letter-spacing: 0;
+  }
+
+  .site-prose > h3 {
+    margin-top: 2rem;
+    color: var(--foreground);
+    font-weight: 500;
+    font-size: 1.125rem;
+    line-height: 1.75rem;
+    letter-spacing: 0;
+  }
+
+  .site-prose > h4 {
+    margin-top: 1.5rem;
+    color: var(--foreground);
+    font-weight: 500;
+    font-size: 1rem;
+    line-height: 1.5rem;
+  }
+
+  .site-prose > p {
+    margin-top: 0.75rem;
+    color: var(--foreground-muted);
+    font-size: 1rem;
+    line-height: 1.5rem;
+  }
+
+  .site-prose > ul,
+  .site-prose > ol {
+    margin-top: 0.75rem;
+    padding-left: 1.25rem;
+  }
+
+  .site-prose > ul {
+    list-style: disc;
+  }
+
+  .site-prose > ol {
+    list-style: decimal;
+  }
+
+  .site-prose > ul li,
+  .site-prose > ol li {
+    color: var(--foreground-muted);
+    font-size: 1rem;
+    line-height: 1.5rem;
+  }
+
+  .site-prose > ul li + li,
+  .site-prose > ol li + li {
+    margin-top: 0.375rem;
+  }
+
+  .site-prose > ul li::marker,
+  .site-prose > ol li::marker {
+    color: var(--foreground-soft);
+  }
+
+  .site-prose > p strong,
+  .site-prose > ul strong,
+  .site-prose > ol strong {
+    color: var(--foreground);
+    font-weight: 500;
+  }
+
+  .site-prose > p a,
+  .site-prose > ul a,
+  .site-prose > ol a,
+  .site-prose td a {
+    color: var(--primary);
+    text-decoration-line: underline;
+    text-decoration-color: var(--primary);
+    text-underline-offset: 4px;
+    transition:
+      color 150ms,
+      text-decoration-color 150ms;
+  }
+
+  .site-prose > p a:hover,
+  .site-prose > ul a:hover,
+  .site-prose > ol a:hover,
+  .site-prose td a:hover {
+    color: var(--primary-hover);
+    text-decoration-color: var(--primary-hover);
+  }
+
+  .site-prose > p code,
+  .site-prose > ul code,
+  .site-prose > ol code,
+  .site-prose > h2 code,
+  .site-prose > h3 code,
+  .site-prose td code {
+    border-radius: 0.375rem;
+    background-color: var(--muted);
+    padding: 0.125rem 0.375rem;
+    font-size: 0.85em;
+  }
+
+  .site-prose > blockquote {
+    margin-top: 1.25rem;
+    border-radius: 0.5rem;
+    background: var(--muted);
+    padding: 1rem 1.25rem;
+    color: var(--foreground-muted);
+  }
+
+  .site-prose > hr {
+    margin-top: 2rem;
+    border-color: var(--border);
+  }
+
+  .site-prose pre {
+    margin-top: 1.25rem;
+    overflow-x: auto;
+    border-radius: 0.5rem;
+    background: var(--muted) !important;
+    padding: 1rem;
+    color: var(--foreground);
+    font-size: 0.875rem;
+    line-height: 1.5rem;
+  }
+
+  .site-prose pre code {
+    border-radius: 0;
+    background-color: transparent;
+    padding: 0;
+    color: var(--foreground);
+    font-size: inherit;
+  }
+
+  .site-prose pre span {
+    color: var(--foreground) !important;
+  }
+
+  .code-frame {
+    position: relative;
+    margin-top: 1.25rem;
+    min-width: 0;
+  }
+
+  .site-prose .code-frame pre {
+    margin-top: 0;
+    padding-right: 3.25rem;
+  }
+
+  .code-copy-strip {
+    position: absolute;
+    top: 0;
+    right: 0;
+    bottom: 0;
+    display: flex;
+    align-items: flex-start;
+    border-radius: 0 0.5rem 0.5rem 0;
+    background: var(--muted);
+    padding: 0.45rem 0.45rem 0 1.75rem;
+  }
+
+  .code-copy-button {
+    display: inline-flex;
+    width: 2rem;
+    height: 2rem;
+    align-items: center;
+    justify-content: center;
+    border-radius: 0.375rem;
+    background: var(--muted);
+    color: var(--foreground-muted);
+    transition: color 150ms;
+  }
+
+  .code-copy-button:hover {
+    color: var(--foreground);
+  }
+
+  .code-copy-icon {
+    width: 1rem;
+    height: 1rem;
+  }
+
+  .code-copy-icon.hidden {
+    display: none;
+  }
+
+  .site-prose table {
+    margin-top: 1.25rem;
+    width: 100%;
+    border-collapse: collapse;
+    font-size: 0.9375rem;
+    line-height: 1.5rem;
+  }
+
+  .site-prose th {
+    border-bottom: 1px solid var(--border);
+    padding: 0.5rem 0.75rem 0.5rem 0;
+    color: var(--foreground);
+    font-weight: 500;
+    text-align: left;
+  }
+
+  .site-prose td {
+    border-bottom: 1px solid var(--border-subtle);
+    padding: 0.5rem 0.75rem 0.5rem 0;
+    color: var(--foreground-muted);
+    vertical-align: top;
+  }
+
+  .site-prose th.text-right,
+  .site-prose td.text-right {
+    text-align: right;
+  }
+
+  .table-frame {
+    margin-top: 1.25rem;
+    overflow-x: auto;
+    overscroll-behavior-inline: contain;
+  }
+
+  .table-frame > table {
+    margin-top: 0;
+  }
+
+  @media (max-width: 40rem) {
+    .site-prose > table {
+      display: block;
+      overflow-x: auto;
+      overscroll-behavior-inline: contain;
+    }
+
+    .site-prose th,
+    .site-prose td {
+      min-width: 9rem;
+    }
+  }
+}
+
+@layer components {
+  /* The shared page frame: centred, full width up to --frame-max, with the
+     standard gutter. The header, footer and every page use it. */
+  .site-frame {
+    margin-inline: auto;
+    width: 100%;
+    max-width: var(--frame-max);
+    padding-inline: 1.5rem;
+  }
+
+  /* The FAQ accordion opens by growing its row from nothing. */
+  .faq-content {
+    grid-template-rows: 0fr;
+    transition: grid-template-rows 200ms ease-out;
+  }
+
+  .faq-content[data-state="open"] {
+    grid-template-rows: 1fr;
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .faq-content {
+      transition: none;
+    }
+  }
+
+  @media (width >= 64rem) {
+    .site-frame {
+      padding-inline: 2.5rem;
+    }
+  }
+}

package/site-kit/starter/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist"]
+}

package/site-kit/starter/wrangler.jsonc

@@ -0,0 +1,16 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  // A static site on Workers static assets. No Worker code runs for pages,
+  // so bots cost nothing. Add "main" and run_worker_first: ["/api/*"] only
+  // when a route really needs the server, and never for Markdown copies:
+  // Cloudflare URL rewrite rules serve those (pnpm rewrites prints them).
+  "name": "example-site",
+  "compatibility_date": "2026-10-01",
+  "assets": {
+    "directory": "./dist",
+    "html_handling": "drop-trailing-slash",
+    "not_found_handling": "404-page"
+  },
+  "preview_urls": true,
+  "observability": { "enabled": false }
+}

package/skills/seo/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: seo
-description: Free Google Search Console MCP server and CLI for AI agents. Reads your real Search Console, Google Analytics, Bing Webmaster Tools and Clicky data, plus DataForSEO and Ahrefs keyword research. Use it for any SEO question - why Google traffic or clicks dropped, organic traffic decline, quick wins, low CTR, striking distance keywords, content decay and declining pages, keyword cannibalization, indexing and URL inspection, one page's queries, Google update impact, the questions people ask AI that show in Search Console, competitor keywords, backlinks, technical SEO crawls, redirects, internal links and client SEO reports. Returns facts from your own data, never guesses.
+description: Free Google Search Console MCP server and CLI for AI agents. Reads your real Search Console, Google Analytics, Bing Webmaster Tools and Clicky data, plus DataForSEO and Ahrefs keyword research. Use it for any SEO question - why Google traffic or clicks dropped, organic traffic decline, quick wins, low CTR, striking distance keywords, content decay and declining pages, keyword cannibalization, indexing and URL inspection, one page's queries, Google update impact, the questions people ask AI that show in Search Console, competitor keywords, backlinks, technical SEO crawls, redirects, internal links, client SEO reports and building a new programmatic SEO site. Returns facts from your own data, never guesses.
 ---
 
 # seo
@@ -28,11 +28,29 @@ link for them to approve, then run it again.
 | `seo crawl --url <url>` | `seo_crawl` | Technical issues across a site |
 | `seo internal-links --site <site>` or `--url <url>` | `seo_internal_links` | Links to add across a site, or to one page |
 | `seo sites` | `seo_sites` | The properties the person can read |
+| `seo site new <folder>`, then `seo site guide <step>` | CLI only | Build a new data-driven site on Astro and Cloudflare, one step at a time. Its build runs `seo site check` |
 
 Each result ends with the command to run next. Start small and ask for more:
 a site, then a `--section` (`section`), then `--detail rows` or `full`.
 `seo <command> --help` shows the options.
 
+## Issues kept between sessions
+
+`seo report --site <site> --section issues` (`section "issues"`) checks the
+site again and keeps a list of what it found, each with an id, the latest
+check (found, not found or not checked) and what the person marked it. When
+the person says they fixed an issue or want it left alone, record it:
+`--mark fixed` or `--mark ignored` with `--issues <id>,<id>` (`mark`,
+`issues`, optional `note`). Read the list at the start of a session instead
+of reporting old issues as new. "Fixed" is the person's word; the list says
+when the check still finds it. The CLI and local MCP keep the list in
+`issues.json`; the hosted server keeps it only for sites in the weekly site
+audit. For any other site the result says the server is not storing it and
+ends with the list as JSON (`{"version":1,"sites":{"<site>":[...]}}`, the
+`issues.json` shape): save it in the person's project, such as
+`.seo/issues.json`, and pass its contents as `saved` with the next `issues`
+or `mark` call so marks carry over.
+
 ## Indexing reasons each week
 
 `seo index` inspects known URLs in a fixed order (lost-click pages, Search