@actuate-media/cms-core 0.28.0 → 0.29.0

package/dist/seo/score.js

@@ -0,0 +1,213 @@
+/**
+ * SEO scoring model.
+ *
+ * Pure, dependency-light functions that turn a page/post's metadata + content
+ * into an explainable 0-100 score, and aggregate per-category signals into a
+ * site-wide score. Nothing here is persisted directly — the audit engine
+ * (Phase 2) calls these and snapshots the results into `SeoAuditRun` /
+ * `SeoIssue` rows, while the Content SEO table recomputes page scores on read.
+ *
+ * The score is intentionally NOT a mystery number: every result carries a
+ * `checks` array describing exactly which points were earned/lost and why, so
+ * the admin UI can show editors what to fix. The unit tests in
+ * `__tests__/seo/score.test.ts` are the source of truth for the weights.
+ */
+import { stripHtmlTags } from './analysis.js';
+/** Page score weights. Must sum to 100. */
+export const PAGE_SEO_WEIGHTS = {
+    metaTitlePresent: 10,
+    metaTitleLength: 5,
+    metaDescPresent: 10,
+    metaDescLength: 5,
+    focusKeyword: 8,
+    canonical: 7,
+    h1: 10,
+    contentLength: 10,
+    ogImage: 8,
+    ogTitleDesc: 5,
+    structuredData: 7,
+    internalLinks: 5,
+    indexable: 10,
+};
+/** Site score category weights (spec). Must sum to 100. */
+export const SITE_SEO_WEIGHTS = {
+    content: 30,
+    technical: 25,
+    linkRedirect: 20,
+    structuredSocial: 15,
+    performance: 10,
+};
+const MIN_CONTENT_WORDS = 300;
+const IMPROVE_CONTENT_WORDS = 150;
+function present(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/** Map a 0-100 score to a grade. Aligns with the Content SEO table colours. */
+export function gradeForSeoScore(score) {
+    if (score >= 80)
+        return 'good';
+    if (score >= 60)
+        return 'fair';
+    if (score >= 1)
+        return 'poor';
+    return 'critical';
+}
+/** Count `<h1>` tags in an HTML string (case-insensitive). */
+export function countH1(html) {
+    const matches = html.match(/<h1[\s>]/gi);
+    return matches ? matches.length : 0;
+}
+function wordCountOf(content) {
+    const text = stripHtmlTags(content);
+    if (!text)
+        return 0;
+    return text.split(/\s+/).filter((w) => w.length > 0).length;
+}
+/**
+ * Compute a page/post SEO score (0-100) with an explainable breakdown.
+ *
+ * Points are additive per {@link PAGE_SEO_WEIGHTS}; "warn" checks earn partial
+ * credit. The total is clamped to 0-100 and rounded.
+ */
+export function calculatePageSeoScore(input) {
+    const checks = [];
+    const push = (id, label, max, status, message) => {
+        const points = status === 'pass' ? max : status === 'warn' ? Math.round(max * 0.5) : 0;
+        checks.push({ id, label, points, max, status, message });
+    };
+    // -- Meta title -----------------------------------------------------------
+    const metaTitle = (input.metaTitle ?? '').trim();
+    if (metaTitle.length === 0) {
+        push('meta-title', 'Meta title', PAGE_SEO_WEIGHTS.metaTitlePresent, 'fail', 'No meta title set.');
+        push('meta-title-length', 'Meta title length', PAGE_SEO_WEIGHTS.metaTitleLength, 'fail', 'Add a 30–60 character meta title.');
+    }
+    else {
+        push('meta-title', 'Meta title', PAGE_SEO_WEIGHTS.metaTitlePresent, 'pass', 'Meta title is set.');
+        const len = metaTitle.length;
+        if (len >= 30 && len <= 60) {
+            push('meta-title-length', 'Meta title length', PAGE_SEO_WEIGHTS.metaTitleLength, 'pass', `Meta title is ${len} characters — ideal.`);
+        }
+        else {
+            push('meta-title-length', 'Meta title length', PAGE_SEO_WEIGHTS.metaTitleLength, 'warn', `Meta title is ${len} characters. Aim for 30–60.`);
+        }
+    }
+    // -- Meta description -----------------------------------------------------
+    const metaDesc = (input.metaDescription ?? '').trim();
+    if (metaDesc.length === 0) {
+        push('meta-description', 'Meta description', PAGE_SEO_WEIGHTS.metaDescPresent, 'fail', 'No meta description set.');
+        push('meta-description-length', 'Meta description length', PAGE_SEO_WEIGHTS.metaDescLength, 'fail', 'Add a 120–160 character description.');
+    }
+    else {
+        push('meta-description', 'Meta description', PAGE_SEO_WEIGHTS.metaDescPresent, 'pass', 'Meta description is set.');
+        const len = metaDesc.length;
+        if (len >= 120 && len <= 160) {
+            push('meta-description-length', 'Meta description length', PAGE_SEO_WEIGHTS.metaDescLength, 'pass', `Meta description is ${len} characters — ideal.`);
+        }
+        else {
+            push('meta-description-length', 'Meta description length', PAGE_SEO_WEIGHTS.metaDescLength, 'warn', `Meta description is ${len} characters. Aim for 120–160.`);
+        }
+    }
+    // -- Focus keyword --------------------------------------------------------
+    push('focus-keyword', 'Focus keyword', PAGE_SEO_WEIGHTS.focusKeyword, present(input.focusKeyword) ? 'pass' : 'warn', present(input.focusKeyword) ? 'Focus keyword is set.' : 'No focus keyword set.');
+    // -- Canonical ------------------------------------------------------------
+    push('canonical', 'Canonical URL', PAGE_SEO_WEIGHTS.canonical, present(input.canonicalUrl) ? 'pass' : 'warn', present(input.canonicalUrl) ? 'Canonical URL is set.' : 'No canonical URL set.');
+    // -- H1 -------------------------------------------------------------------
+    const content = input.content ?? '';
+    const h1Count = countH1(content);
+    if (h1Count === 1) {
+        push('h1', 'H1 heading', PAGE_SEO_WEIGHTS.h1, 'pass', 'Exactly one H1 heading.');
+    }
+    else if (h1Count === 0) {
+        push('h1', 'H1 heading', PAGE_SEO_WEIGHTS.h1, content.length === 0 ? 'warn' : 'fail', 'No H1 heading found.');
+    }
+    else {
+        push('h1', 'H1 heading', PAGE_SEO_WEIGHTS.h1, 'warn', `Found ${h1Count} H1 headings. Use exactly one.`);
+    }
+    // -- Content length -------------------------------------------------------
+    const words = typeof input.wordCount === 'number' ? input.wordCount : wordCountOf(content);
+    if (words >= MIN_CONTENT_WORDS) {
+        push('content-length', 'Content length', PAGE_SEO_WEIGHTS.contentLength, 'pass', `${words} words — meets the ${MIN_CONTENT_WORDS}-word minimum.`);
+    }
+    else if (words >= IMPROVE_CONTENT_WORDS) {
+        push('content-length', 'Content length', PAGE_SEO_WEIGHTS.contentLength, 'warn', `${words} words. Aim for ${MIN_CONTENT_WORDS}+.`);
+    }
+    else {
+        push('content-length', 'Content length', PAGE_SEO_WEIGHTS.contentLength, 'fail', `Only ${words} words. Aim for ${MIN_CONTENT_WORDS}+.`);
+    }
+    // -- OG image -------------------------------------------------------------
+    push('og-image', 'Open Graph image', PAGE_SEO_WEIGHTS.ogImage, present(input.ogImage) ? 'pass' : 'warn', present(input.ogImage) ? 'OG image is set.' : 'No OG image — social shares show a placeholder.');
+    // -- OG title / description ----------------------------------------------
+    push('og-title-desc', 'Open Graph title & description', PAGE_SEO_WEIGHTS.ogTitleDesc, present(input.ogTitle) || present(input.ogDescription) ? 'pass' : 'warn', present(input.ogTitle) || present(input.ogDescription)
+        ? 'OG title/description set or inherited.'
+        : 'No OG title/description set.');
+    // -- Structured data ------------------------------------------------------
+    push('structured-data', 'Structured data', PAGE_SEO_WEIGHTS.structuredData, present(input.structuredDataType) ? 'pass' : 'warn', present(input.structuredDataType)
+        ? `Schema type: ${input.structuredDataType}.`
+        : 'No structured data type set.');
+    // -- Internal links -------------------------------------------------------
+    const broken = input.brokenInternalLinks ?? 0;
+    push('internal-links', 'Internal links', PAGE_SEO_WEIGHTS.internalLinks, broken === 0 ? 'pass' : 'fail', broken === 0 ? 'No broken internal links.' : `${broken} broken internal link(s).`);
+    // -- Indexability ---------------------------------------------------------
+    const shouldIndex = input.shouldBeIndexable !== false;
+    const accidentalNoindex = shouldIndex && input.noindex === true;
+    push('indexable', 'Indexability', PAGE_SEO_WEIGHTS.indexable, accidentalNoindex ? 'fail' : 'pass', accidentalNoindex
+        ? 'Page is set to noindex but should be indexable.'
+        : 'Indexability is correct.');
+    const earned = checks.reduce((sum, c) => sum + c.points, 0);
+    const score = Math.max(0, Math.min(100, Math.round(earned)));
+    return { score, grade: gradeForSeoScore(score), checks };
+}
+function clampScore(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(100, n));
+}
+/**
+ * Combine per-category sub-scores into a weighted 0-100 site score.
+ *
+ * Performance defaults to 70 (neutral) when not supplied, so sites without a
+ * connected performance source aren't unfairly penalised — the weight is still
+ * applied so connecting Search Console can only improve the signal's accuracy.
+ */
+export function calculateSiteSeoScore(input) {
+    const categories = [
+        {
+            category: 'content',
+            score: clampScore(input.content),
+            weight: SITE_SEO_WEIGHTS.content,
+            contribution: 0,
+        },
+        {
+            category: 'technical',
+            score: clampScore(input.technical),
+            weight: SITE_SEO_WEIGHTS.technical,
+            contribution: 0,
+        },
+        {
+            category: 'linkRedirect',
+            score: clampScore(input.linkRedirect),
+            weight: SITE_SEO_WEIGHTS.linkRedirect,
+            contribution: 0,
+        },
+        {
+            category: 'structuredSocial',
+            score: clampScore(input.structuredSocial),
+            weight: SITE_SEO_WEIGHTS.structuredSocial,
+            contribution: 0,
+        },
+        {
+            category: 'performance',
+            score: clampScore(input.performance ?? 70),
+            weight: SITE_SEO_WEIGHTS.performance,
+            contribution: 0,
+        },
+    ];
+    let total = 0;
+    for (const c of categories) {
+        c.contribution = (c.score * c.weight) / 100;
+        total += c.contribution;
+    }
+    const score = Math.max(0, Math.min(100, Math.round(total)));
+    return { score, grade: gradeForSeoScore(score), breakdown: categories };
+}
+//# sourceMappingURL=score.js.map

package/dist/seo/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/seo/score.ts"],"names":[],"mappings":"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"}

package/dist/setup/index.d.ts

@@ -19,9 +19,24 @@ export interface SetupResult {
     error?: string;
     userId?: string;
 }
+/**
+ * Detect errors that mean the database is unreachable / not initialized,
+ * as opposed to an empty-but-healthy database.
+ *
+ * We must NOT treat these as "needs setup": doing so makes a DB outage
+ * silently render the first-run account-creation wizard, and the
+ * subsequent create-admin write then fails with an opaque 400. Surfacing
+ * the error instead lets callers return a proper 5xx and lets operators
+ * see the real cause (e.g. `ECONNREFUSED`, Prisma `P1001`).
+ */
+export declare function isDatabaseUnavailableError(err: unknown): boolean;
 /**
  * Check if the CMS needs first-run setup (no admin users exist).
- * Uses a raw count query to avoid loading the full user model.
+ * Uses a count query to avoid loading the full user model.
+ *
+ * A connection/initialization failure is rethrown so callers can report
+ * it as an infrastructure error — only a successful query that returns
+ * zero users counts as "setup required".
  */
 export declare function checkSetupRequired(db: any): Promise<SetupStatus>;
 /**

package/dist/setup/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAOtE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAoC/F;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAgBxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA4BhE;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAQtE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuC/F;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAgBxE"}

package/dist/setup/index.js

@@ -6,16 +6,62 @@
  * 2. Automated — env-var-based admin creation for CI/headless deploys
  */
 import { hashPassword } from '../auth/password.js';
+/**
+ * Detect errors that mean the database is unreachable / not initialized,
+ * as opposed to an empty-but-healthy database.
+ *
+ * We must NOT treat these as "needs setup": doing so makes a DB outage
+ * silently render the first-run account-creation wizard, and the
+ * subsequent create-admin write then fails with an opaque 400. Surfacing
+ * the error instead lets callers return a proper 5xx and lets operators
+ * see the real cause (e.g. `ECONNREFUSED`, Prisma `P1001`).
+ */
+export function isDatabaseUnavailableError(err) {
+    if (!err || typeof err !== 'object')
+        return false;
+    const code = err.code;
+    const name = err.name;
+    // Prisma connection/init error codes: can't reach server, timeouts,
+    // auth failures, db-does-not-exist, and the raw socket error.
+    const connectionCodes = new Set([
+        'P1000',
+        'P1001',
+        'P1002',
+        'P1003',
+        'P1008',
+        'P1017',
+        'ECONNREFUSED',
+        'ETIMEDOUT',
+        'ENOTFOUND',
+    ]);
+    if (typeof code === 'string' && connectionCodes.has(code))
+        return true;
+    if (name === 'PrismaClientInitializationError')
+        return true;
+    const message = err.message;
+    if (typeof message === 'string') {
+        return (message.includes('ECONNREFUSED') ||
+            message.includes("Can't reach database server") ||
+            message.includes('Authentication failed against database'));
+    }
+    return false;
+}
 /**
  * Check if the CMS needs first-run setup (no admin users exist).
- * Uses a raw count query to avoid loading the full user model.
+ * Uses a count query to avoid loading the full user model.
+ *
+ * A connection/initialization failure is rethrown so callers can report
+ * it as an infrastructure error — only a successful query that returns
+ * zero users counts as "setup required".
  */
 export async function checkSetupRequired(db) {
     try {
         const userCount = await db.user.count();
         return { setupRequired: userCount === 0, userCount };
     }
-    catch {
+    catch (err) {
+        if (isDatabaseUnavailableError(err))
+            throw err;
         return { setupRequired: true, userCount: 0 };
     }
 }
@@ -52,6 +98,10 @@ export async function createInitialAdmin(db, input) {
         return { success: true, userId: user.id };
     }
     catch (err) {
+        // A DB outage is an infrastructure failure, not a bad request —
+        // rethrow so the caller can return a 5xx instead of a confusing 400.
+        if (isDatabaseUnavailableError(err))
+            throw err;
         const message = err instanceof Error ? err.message : 'Setup failed';
         return { success: false, error: message };
     }

package/dist/setup/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actuate-media/cms-core",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/actuate-media/actuatecms.git",

package/prisma/migrations/0008_media_center/migration.sql

@@ -0,0 +1,47 @@
+-- Media Center
+--
+-- Extends actuate_media with the metadata the Media Center needs: SEO fields
+-- (caption / description / focusKeyword), provenance (originalFileName), a
+-- normalised storage split (publicUrl / storageProvider), media processing
+-- artefacts (thumbnailUrl / responsiveVariants / durationSeconds), a tags
+-- bag, soft-delete (deletedAt), and a processing status.
+--
+-- SEO score and issues are deliberately NOT persisted — they are derived on
+-- read by `calculateMediaSeoScore()` so they never drift from the metadata.
+--
+-- Safe to apply to a populated database:
+--   * Every new column is nullable or has a default — no backfill required.
+--   * `status` defaults to READY so existing rows are immediately valid.
+--   * No existing column is dropped or retyped.
+
+-- ---------------------------------------------------------------------------
+-- MediaStatus enum
+-- ---------------------------------------------------------------------------
+CREATE TYPE "MediaStatus" AS ENUM (
+  'PROCESSING',
+  'READY',
+  'FAILED'
+);
+
+-- ---------------------------------------------------------------------------
+-- actuate_media new columns
+-- ---------------------------------------------------------------------------
+ALTER TABLE "actuate_media"
+  ADD COLUMN "originalFileName"   TEXT,
+  ADD COLUMN "caption"            TEXT,
+  ADD COLUMN "description"        TEXT,
+  ADD COLUMN "focusKeyword"       TEXT,
+  ADD COLUMN "tags"               JSONB,
+  ADD COLUMN "publicUrl"          TEXT,
+  ADD COLUMN "storageProvider"    TEXT,
+  ADD COLUMN "durationSeconds"    DOUBLE PRECISION,
+  ADD COLUMN "thumbnailUrl"       TEXT,
+  ADD COLUMN "responsiveVariants" JSONB,
+  ADD COLUMN "status"             "MediaStatus" NOT NULL DEFAULT 'READY',
+  ADD COLUMN "deletedAt"          TIMESTAMP(3);
+
+-- ---------------------------------------------------------------------------
+-- Indexes backing the new query filters (soft-delete + type filtering)
+-- ---------------------------------------------------------------------------
+CREATE INDEX "actuate_media_deletedAt_idx" ON "actuate_media" ("deletedAt");
+CREATE INDEX "actuate_media_mimeType_idx" ON "actuate_media" ("mimeType");

package/prisma/migrations/0009_seo/migration.sql

@@ -0,0 +1,143 @@
+-- SEO Operations Center
+--
+-- Adds the persistence layer for the SEO module:
+--   * Redirect: runtime + management columns (enabled, priority, preserveQuery,
+--     source_kind, hits, lastHitAt, createdById).
+--   * SeoAuditRun: one row per audit execution (score + issue-count snapshot).
+--   * SeoIssue: detected SEO problems, status carried across runs via issueKey.
+--   * Redirect404Hit: aggregated 404 traffic observed by the middleware.
+--   * RedirectSuggestion: confidence-scored 404 recovery / chain suggestions.
+--
+-- Safe to apply to a populated database:
+--   * Every new Redirect column is nullable or has a default — no backfill.
+--   * New tables/enums are additive; no existing column is dropped or retyped.
+
+-- ---------------------------------------------------------------------------
+-- Enums
+-- ---------------------------------------------------------------------------
+CREATE TYPE "SeoAuditStatus" AS ENUM ('RUNNING', 'COMPLETED', 'FAILED');
+CREATE TYPE "SeoIssueSeverity" AS ENUM ('critical', 'warning', 'info');
+CREATE TYPE "SeoIssueStatus" AS ENUM ('open', 'ignored', 'resolved', 'recurring');
+CREATE TYPE "SeoIssueCategory" AS ENUM (
+  'content', 'technical', 'redirects', 'media',
+  'performance', 'schema', 'social', 'indexing'
+);
+
+-- ---------------------------------------------------------------------------
+-- actuate_redirects new columns
+-- ---------------------------------------------------------------------------
+ALTER TABLE "actuate_redirects"
+  ADD COLUMN "enabled"       BOOLEAN NOT NULL DEFAULT true,
+  ADD COLUMN "priority"      INTEGER NOT NULL DEFAULT 0,
+  ADD COLUMN "preserveQuery" BOOLEAN NOT NULL DEFAULT false,
+  ADD COLUMN "source_kind"   TEXT NOT NULL DEFAULT 'manual',
+  ADD COLUMN "hits"          INTEGER NOT NULL DEFAULT 0,
+  ADD COLUMN "lastHitAt"     TIMESTAMP(3),
+  ADD COLUMN "createdById"   TEXT;
+
+CREATE INDEX "actuate_redirects_enabled_idx" ON "actuate_redirects" ("enabled");
+CREATE INDEX "actuate_redirects_lastHitAt_idx" ON "actuate_redirects" ("lastHitAt");
+
+-- ---------------------------------------------------------------------------
+-- actuate_seo_audit_runs
+-- ---------------------------------------------------------------------------
+CREATE TABLE "actuate_seo_audit_runs" (
+  "id"              TEXT NOT NULL,
+  "status"          "SeoAuditStatus" NOT NULL DEFAULT 'RUNNING',
+  "scope"           TEXT NOT NULL DEFAULT 'full',
+  "startedById"     TEXT,
+  "startedAt"       TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "finishedAt"      TIMESTAMP(3),
+  "siteScoreBefore" INTEGER,
+  "siteScoreAfter"  INTEGER,
+  "pagesScanned"    INTEGER NOT NULL DEFAULT 0,
+  "issuesFound"     INTEGER NOT NULL DEFAULT 0,
+  "criticalCount"   INTEGER NOT NULL DEFAULT 0,
+  "warningCount"    INTEGER NOT NULL DEFAULT 0,
+  "infoCount"       INTEGER NOT NULL DEFAULT 0,
+  "errorMessage"    TEXT,
+  "metadata"        JSONB,
+  CONSTRAINT "actuate_seo_audit_runs_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "actuate_seo_audit_runs_status_idx" ON "actuate_seo_audit_runs" ("status");
+CREATE INDEX "actuate_seo_audit_runs_startedAt_idx" ON "actuate_seo_audit_runs" ("startedAt");
+
+-- ---------------------------------------------------------------------------
+-- actuate_seo_issues
+-- ---------------------------------------------------------------------------
+CREATE TABLE "actuate_seo_issues" (
+  "id"               TEXT NOT NULL,
+  "auditRunId"       TEXT,
+  "issueKey"         TEXT NOT NULL,
+  "entityType"       TEXT,
+  "entityId"         TEXT,
+  "entityTitle"      TEXT,
+  "url"              TEXT,
+  "severity"         "SeoIssueSeverity" NOT NULL,
+  "category"         "SeoIssueCategory" NOT NULL,
+  "type"             TEXT NOT NULL,
+  "title"            TEXT NOT NULL,
+  "description"      TEXT,
+  "impact"           TEXT,
+  "recommendation"   TEXT,
+  "status"           "SeoIssueStatus" NOT NULL DEFAULT 'open',
+  "fixable"          BOOLEAN NOT NULL DEFAULT false,
+  "fixActionType"    TEXT,
+  "relatedEntityIds" JSONB,
+  "source"           TEXT NOT NULL DEFAULT 'audit',
+  "firstDetectedAt"  TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "lastDetectedAt"   TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "resolvedAt"       TIMESTAMP(3),
+  "resolvedById"     TEXT,
+  "metadata"         JSONB,
+  CONSTRAINT "actuate_seo_issues_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "actuate_seo_issues_auditRunId_idx" ON "actuate_seo_issues" ("auditRunId");
+CREATE INDEX "actuate_seo_issues_status_idx" ON "actuate_seo_issues" ("status");
+CREATE INDEX "actuate_seo_issues_severity_idx" ON "actuate_seo_issues" ("severity");
+CREATE INDEX "actuate_seo_issues_category_idx" ON "actuate_seo_issues" ("category");
+CREATE INDEX "actuate_seo_issues_issueKey_idx" ON "actuate_seo_issues" ("issueKey");
+
+ALTER TABLE "actuate_seo_issues"
+  ADD CONSTRAINT "actuate_seo_issues_auditRunId_fkey"
+  FOREIGN KEY ("auditRunId") REFERENCES "actuate_seo_audit_runs"("id")
+  ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- ---------------------------------------------------------------------------
+-- actuate_redirect_404_hits
+-- ---------------------------------------------------------------------------
+CREATE TABLE "actuate_redirect_404_hits" (
+  "id"          TEXT NOT NULL,
+  "path"        TEXT NOT NULL,
+  "hits"        INTEGER NOT NULL DEFAULT 1,
+  "referrer"    TEXT,
+  "resolvedAt"  TIMESTAMP(3),
+  "firstSeenAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "lastSeenAt"  TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  CONSTRAINT "actuate_redirect_404_hits_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX "actuate_redirect_404_hits_path_key" ON "actuate_redirect_404_hits" ("path");
+CREATE INDEX "actuate_redirect_404_hits_lastSeenAt_idx" ON "actuate_redirect_404_hits" ("lastSeenAt");
+
+-- ---------------------------------------------------------------------------
+-- actuate_redirect_suggestions
+-- ---------------------------------------------------------------------------
+CREATE TABLE "actuate_redirect_suggestions" (
+  "id"         TEXT NOT NULL,
+  "fromPath"   TEXT NOT NULL,
+  "toPath"     TEXT NOT NULL,
+  "confidence" INTEGER NOT NULL DEFAULT 0,
+  "reason"     TEXT,
+  "status"     TEXT NOT NULL DEFAULT 'open',
+  "source"     TEXT NOT NULL DEFAULT 'ai-404-recovery',
+  "metadata"   JSONB,
+  "createdAt"  TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "updatedAt"  TIMESTAMP(3) NOT NULL,
+  CONSTRAINT "actuate_redirect_suggestions_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "actuate_redirect_suggestions_status_idx" ON "actuate_redirect_suggestions" ("status");
+CREATE INDEX "actuate_redirect_suggestions_fromPath_idx" ON "actuate_redirect_suggestions" ("fromPath");