SEO Suite

Package docs status

This page is generated from package source documentation in the Capell packages repository and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account.

Field	Value
Composer package	`capell-app/seo-suite`
Package slug	`seo-suite`
Product group	Capell Search & SEO
Tier	premium
Bundle	`search-seo`
Runtime contexts	`admin`, `frontend`, `console`
Capell version	`^1.0`
Catalogue role	extension
Release channel	Beta
Source repository	`capell-app/packages`
Source path	`packages/seo-suite`
Docs source	`packages/seo-suite/docs`
Manifest	`capell.json`

What This Plugin Adds

SEO Suite is an Available, Schema-owning Capell package in the Capell Search & SEO product group. It ships as capell-app/seo-suite and extends these surfaces: admin, frontend, console.

SEO Suite adds page audits, structured data, broken-link review, Search Console reporting, and observed AI-discovery outputs such as llms.txt and page Markdown.

Editors can inspect SEO issues and broken links, review search performance, and work through page-level recommendations. Operators can reconcile bounded public-output observations without treating configured state as fetched evidence.

Status details:

Status: Available
Tier: premium
Bundle: search-seo
Composer package: capell-app/seo-suite
Namespace: Capell\SeoSuite
Theme key: not applicable

Why It Matters

For developers: Actions consolidate audit rules, schema resolution, telemetry, generated discovery output, and signed publish observations around typed page and site boundaries.

For teams: Teams can find page and link problems, prioritize search opportunities, and distinguish current crawler-facing output from cryptographically correlated publish-regeneration proof.

Screens And Workflow

Screenshot contract: docs/screenshots.json.

Page SEO panel (admin, supplementary evidence).
SEO audit page (admin, required evidence).
Search Console insights panel (admin, supplementary evidence).
Broken links page (admin, supplementary evidence).
AI Creator action modal (admin, supplementary evidence).
Sitemap page (admin, required evidence).
Translation coverage page (admin, supplementary evidence).
AI discovery page (admin, supplementary evidence).
Search rankings page (admin, supplementary evidence).
PageSpeed audit widget (admin, supplementary evidence).
Create redirect from broken link action (admin, supplementary evidence).
Public AI discovery index (public, supplementary evidence).

Works With

Blog: optional integration backed by the interop evidence map.
Publishing Studio: optional integration backed by the interop evidence map.
Socials: optional integration backed by the interop evidence map.
Url Manager: optional integration backed by the interop evidence map.

Technical Shape

Service providers

Capell\SeoSuite\Providers\SeoSuiteServiceProvider

Config files

packages/seo-suite/config/capell-seo-suite.php
packages/seo-suite/config/exchanger.php

Migrations

packages/seo-suite/database/migrations/2026_05_10_190870_01_create_ai_creator_contexts_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_03_create_ai_creator_sessions_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_04_create_ai_discovery_crawler_rules_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_05_create_ai_discovery_page_profiles_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_06_create_ai_discovery_site_profiles_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_07_create_ai_discovery_snapshots_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_08_create_broken_links_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_09_create_page_seo_snapshots_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_10_create_search_console_url_metrics_table.php
packages/seo-suite/database/migrations/2026_05_10_190870_11_create_search_console_query_metrics_table.php
packages/seo-suite/database/migrations/2026_05_29_000001_create_page_speed_audit_runs_table.php
packages/seo-suite/database/migrations/2026_05_29_000002_create_page_speed_audit_results_table.php
packages/seo-suite/database/migrations/2026_07_20_000001_create_aeo_publish_observation_requests_table.php
packages/seo-suite/database/migrations/2026_07_20_000002_add_execution_to_aeo_publish_observation_requests_table.php
packages/seo-suite/database/migrations/2026_07_20_000003_create_aeo_pre_publication_captures_table.php
packages/seo-suite/database/migrations/2026_09_08_000001_create_seo_audit_runs_table.php
packages/seo-suite/database/migrations/2026_09_29_120000_remove_implicit_timestamp_updates_from_seo_suite.php
packages/seo-suite/database/migrations/2026_10_04_000001_remove_implicit_timestamp_updates_from_seo_suite.php

Settings migrations

packages/seo-suite/database/settings/2026_05_10_190871_03_create_seo_suite_settings.php
packages/seo-suite/database/settings/2026_05_29_000001_add_pagespeed_seo_suite_settings.php
packages/seo-suite/database/settings/2026_06_07_000001_add_seo_authoring_quality_gate_settings.php

Settings classes

SeoSuiteSettings

Models

AeoPrePublicationCapture
AeoPublishObservationRequest
AiCreatorContext
AiCreatorSession
AiDiscoveryCrawlerRule
AiDiscoveryPageProfile
AiDiscoverySiteProfile
AiDiscoverySnapshot
BrokenLink
PageSeoSnapshot
PageSpeedAuditResult
PageSpeedAuditRun
SearchConsoleQueryMetric
SearchConsoleUrlMetric
SeoAuditRun

Filament classes

AiContentBriefAction
AiCreatorAction
AiImageGeneratorAction
CreateRedirectFromBrokenLinkAction
PageSeoPanel
TranslationSeoMetaSchema
SearchMetaDataSection
MetaSchema
TranslationMetaSchema
SeoOverviewPageTableExtender
PageSeoPanelSchemaExtender
PageSeoSettingsTabExtender
SearchMetaSchemaExtender
PageSpeedPageTableExtender
SiteDetailsMetaExtender
SiteTranslationMetaExtender
AiDiscoveryPage
BrokenLinksPage
NotFoundUrlsPage
SearchRankingsPage
SeoAuditPage
SeoSuiteSettingsPage
AiDiscoveryTable
BrokenLinksTable
SeoAuditTable
TranslationCoverageTable
TranslationCoveragePage
ListPageSeoAuditWidget
SeoSuiteDashboardSettingsContributor
SeoSettingsSchema
StructuredDataSettingsSchema
AiDiscoveryCoverageFilamentWidget
AiMetricsFilamentWidget
AiUsageFilamentWidget
BrokenLinksOverviewFilamentWidget
BuildsSearchConsolePageTable
ResolvesEditPageRecord
EditPageAuditTabsFilamentWidget
EditPagePageSpeedAuditBadge
EditPagePageSpeedAuditFilamentWidget
EditPageSeoAuditBadge
EditPageSeoAuditFilamentWidget
SearchConsoleOverviewFilamentWidget
SearchIntelligenceFilamentWidget
SearchMovementFilamentWidget
SeoOpportunitiesFilamentWidget
TopSearchPagesFilamentWidget

Policies

AiCreatorPolicy

Extension contracts

ActionContract
ContentTargetContract
ExchangerInterface
SearchMetaDataSectionExtender
PageSpeedInsightsClientInterface
SchemaTemplate
SearchMetaDataSectionExtenderResolverInterface
SearchConsoleClientInterface
SeoPublishReportProvider

Listeners

CaptureAeoOutputsBeforePublication
ClearAiDiscoveryCacheOnPageDeleted
ClearAiDiscoveryCacheOnPageSaved
QueueAeoOutputsAfterPublication
QueueAeoPublishObservationOnPageSaved
SeedAiCrawlerRulesOnSiteCreated
RecordBrokenLink
RefreshPageSeoSnapshotOnPublication

Actions

AnalyzePageContentAction
ApplyAiDraftAction
BaseAction
BreadcrumbsSchemaAction
BuildAeoAuditReportAction
BuildAeoPublishObservationEnvelopeAction
BuildAiDiscoveryPageEntriesAction
BuildAiReadinessAuditAction
BuildAiRobotsTxtRulesAction
BuildAnswerEngineReadinessAction
BuildCitationCoverageReportAction
BuildCrawlerPreviewReportAction
BuildDecliningSearchConsolePagesAction
BuildMarketplaceStructuredDataFreshnessWarningsAction
BuildPageImageSchemaAction
BuildPageIntelligenceSummaryAction
BuildPageSearchConsoleInsightsAction
BuildPageSeoReportAction
BuildRedirectOpportunityReportAction
BuildRobotsTxtAction
BuildSchemaTemplateReportAction
BuildSeoAeoAuditAction
BuildSeoAuditSummaryAction
BuildSeoAuthoringQualityGateReadinessReportAction
BuildSeoAuthoringQualityGateResultsAction
BuildSeoIntelligenceOpportunitiesAction
BuildSeoSuiteDoctorReportAction
BuildSocialMetaAction
CalculateSeoScoreAction
ClearAiDiscoveryCacheAction
CreateRedirectForBrokenLinkAction
BuildAiDiscoveryCoverageStatsAction
BuildSearchConsoleDashboardStatsAction
BuildSearchConsolePageRowsAction
BuildSeoIntelligenceRowsAction
BuildSeoOpportunityRowsAction
ResolveSeoOverviewIssuePageIdsAction
BuildAiDiscoveryPageQueryAction
BuildBrokenLinksDashboardStatsAction
BuildBrokenLinksQueryAction
BuildSeoAuditQueryAction
BuildTranslationCoverageQueryAction
FetchAeoPublicOutputAction
FillAiDiscoveryPageSummaryAction
GenerateAiContentBriefAction
GenerateAiImageAction
GenerateAiLayoutAction
GenerateLlmsFullTxtAction
GenerateLlmsTxtAction
GeneratePageMarkdownAction
InstallSeoSuitePackageAction
NormalizeAeoObservationRequestIdsAction
NormalizeTargetKeywordsAction
ObserveAeoRuntimePublicOutputsAction
PageIsDiscoverableForAiDiscoveryAction
PageMetaSchemaAction
PersistAiDiscoverySnapshotAction
PersistPageSeoSnapshotAction
PersistPageSpeedAuditResultAction
PersistSearchConsoleQueryMetricAction
PersistSearchConsoleUrlMetricAction
PruneSeoTelemetryAction
QueueAeoPublishObservationRequestsAction
QueueSeoAuditAction
RecordAiGenerationAction
RecordBrokenLinkAction
RefreshAiDiscoveryPageProfileMarkdownAction
RefreshPageSeoSnapshotAction
RefreshSiteSeoSnapshotsAction
RefreshStaleAiDiscoveryMarkdownAction
RegenerateLlmsFullTxtAction
RenderContentMarkdownAction
ResolveAiDiscoveryPageProfileAction
ResolveAiDiscoveryProfileAction
ResolvePageSpeedAuditTargetsAction
ResolvePageStructuredDataAction
RunAeoPublishObservationRequestAction
RunPageSpeedAuditAction
SchemaGraphAction
SeedDefaultAiCrawlerRulesAction
SeedSeoScreenshotFixtureAction
SendPageSpeedAuditDigestAction
SiteMetaSchemaAction
SubmitAiCreatorDraftAction
SuggestInternalLinksAction
SyncAiDiscoveryPageProfilesAction
SyncSearchConsoleInsightsAction
UpdateAiDiscoveryPageInclusionAction
UpdateAiDiscoveryPageProfileAction

Data objects

AeoAuditEvidenceData
AeoAuditFindingData
AeoAuditRecommendationData
AeoAuditReportData
AeoAuditRequestData
AeoExpectedPublishEventData
AeoPublicOutputCaptureData
AeoPublishObservationEnvelopeData
AeoRuntimeObservationRequestData
AiContentBriefData
AiDiscoveryAuditData
AiDiscoveryCrawlerRuleData
AiDiscoveryPageEntryData
AiDiscoveryRenderContextData
AiReadinessIssueData
AnswerEngineReadinessData
CitationCoverageReportData
CitationEvidenceData
CrawlerPreviewData
AiMetricsData
BrokenLinksDashboardStatsData
SearchConsoleDashboardStatsData
InternalLinkSuggestionData
PageContentAnalysisData
PageIntelligenceSummaryData
PageSeoReportData
PageSpeedAuditDigestFindingData
PageSpeedAuditItemData
PageSpeedAuditResultData
PageSpeedAuditSummaryData
PageSpeedAuditTargetData
PromptData
RedirectOpportunityData
SchemaTemplateReportData
SearchConsoleInsightData
SearchConsoleRankingRowData
SeoAeoAuditRequestData
SeoAeoAuditResultData
SeoAuditSummaryData
SeoAuthoringQualityGateReadinessRowData
SeoAuthoringQualityGateResultData
SeoCheckData
SeoIssueData
SeoOpportunityRowData
SeoPreviewData
SeoScoreBreakdownData
SeoScoreCategoryData
SeoSuiteDoctorCheckData
SocialMetaData

Jobs

RegenerateLlmsFullTxtJob
RunAeoPublishObservationJob
RunPageSpeedAuditJob
RunSeoAuditJob

Command signatures

capell:admin-clear-ai-cache
capell:admin-monitor-ai-usage
capell:admin-test-openai
capell:seo-suite-doctor
capell:seo-suite-install
capell:seo-suite-setup
capell:seo-suite-sync-search-console
capell:seo-suite:aeo-observations
capell:seo-suite:pagespeed-audit
capell:seo-suite:prune
capell:seo-suite:refresh-ai-discovery-markdown
capell:seo-suite:refresh-seo-snapshots
capell:seo-suite:screenshot-fixture

Manifest action API

buildAnswerEngineReadiness: Capell\SeoSuite\Actions\BuildAnswerEngineReadinessAction
buildCitationCoverageReport: Capell\SeoSuite\Actions\BuildCitationCoverageReportAction
buildCrawlerPreviewReport: Capell\SeoSuite\Actions\BuildCrawlerPreviewReportAction
buildMarketplaceStructuredDataFreshnessWarnings: Capell\SeoSuite\Actions\BuildMarketplaceStructuredDataFreshnessWarningsAction
buildSchemaTemplateReport: Capell\SeoSuite\Actions\BuildSchemaTemplateReportAction
buildSeoAeoAudit: Capell\SeoSuite\Actions\BuildSeoAeoAuditAction
buildSeoSuiteDoctorReport: Capell\SeoSuite\Actions\BuildSeoSuiteDoctorReportAction
clearAiDiscoveryCache: Capell\SeoSuite\Actions\ClearAiDiscoveryCacheAction
install: Capell\SeoSuite\Actions\InstallSeoSuitePackageAction
observeAeoRuntimePublicOutputs: Capell\SeoSuite\Actions\ObserveAeoRuntimePublicOutputsAction
pruneSeoTelemetry: Capell\SeoSuite\Actions\PruneSeoTelemetryAction
refreshStaleAiDiscoveryMarkdown: Capell\SeoSuite\Actions\RefreshStaleAiDiscoveryMarkdownAction
runAeoPublishObservationRequest: Capell\SeoSuite\Actions\RunAeoPublishObservationRequestAction
syncAiDiscoveryPageProfiles: Capell\SeoSuite\Actions\SyncAiDiscoveryPageProfilesAction

Scheduled commands

capell:seo-suite:aeo-observations (everyMinute; package registered)
capell:seo-suite:pagespeed-audit --notify (weeklyOn:1:06:00; manifest declared)
capell:seo-suite:prune (daily; manifest declared)
capell:seo-suite:refresh-seo-snapshots (dailyAt:02:30; package registered)

Console command classes

ClearAiCacheCommand
DoctorCommand
InstallCommand
MonitorAiUsageCommand
PageSpeedAuditCommand
PruneSeoTelemetryCommand
ReconcileAeoPublishObservationsCommand
RefreshAiDiscoveryMarkdownCommand
RefreshSeoSnapshotsCommand
SeedSeoScreenshotFixtureCommand
SetupCommand
SyncSearchConsoleCommand
TestOpenAiConnectionCommand

Manifest contributions

admin-page: Capell\SeoSuite\Manifest\AiDiscoveryPageContribution
admin-page: Capell\SeoSuite\Manifest\BrokenLinksPageContribution
admin-page: Capell\SeoSuite\Manifest\NotFoundUrlsPageContribution
admin-page: Capell\SeoSuite\Manifest\SearchRankingsPageContribution
admin-page: Capell\SeoSuite\Manifest\SeoAuditPageContribution
admin-page: Capell\SeoSuite\Manifest\TranslationCoveragePageContribution
console-command: Capell\SeoSuite\Manifest\SeoSuiteConsoleCommandsContribution
dashboard-widget: Capell\SeoSuite\Manifest\SeoSuiteDashboardFilamentWidgetsContribution
health-check: Capell\SeoSuite\Manifest\SeoSuiteHealthContribution
migration: Capell\SeoSuite\Manifest\SeoSuiteMigrationsContribution
model: Capell\SeoSuite\Manifest\SeoSuiteModelsContribution
route: Capell\SeoSuite\Manifest\AiDiscoveryRoutesContribution
scheduled-job: Capell\SeoSuite\Manifest\SeoSuiteAeoObservationScheduleContribution
scheduled-job: Capell\SeoSuite\Manifest\SeoSuitePageSpeedScheduleContribution
scheduled-job: Capell\SeoSuite\Manifest\SeoSuiteRefreshSeoSnapshotsScheduleContribution
scheduled-job: Capell\SeoSuite\Manifest\SeoSuiteRetentionScheduleContribution
setting: Capell\SeoSuite\Manifest\SeoSuiteSettingsContribution

Health checks

Capell\SeoSuite\Health\SeoSuiteHealthCheck

Blade views

packages/seo-suite/resources/views/components/schema/breadcrumb.blade.php
packages/seo-suite/resources/views/components/schema/graph.blade.php
packages/seo-suite/resources/views/components/schema/image.blade.php
packages/seo-suite/resources/views/components/schema/organization.blade.php
packages/seo-suite/resources/views/components/schema/webpage.blade.php
packages/seo-suite/resources/views/components/schema/website.blade.php
packages/seo-suite/resources/views/filament/components/page-seo-panel.blade.php
packages/seo-suite/resources/views/filament/fields/image-preview.blade.php
packages/seo-suite/resources/views/filament/pages/seo-audit.blade.php
packages/seo-suite/resources/views/filament/widgets/ai-metrics.blade.php
packages/seo-suite/resources/views/filament/widgets/ai-usage.blade.php
packages/seo-suite/resources/views/filament/widgets/edit-page-audit-tabs.blade.php
packages/seo-suite/resources/views/filament/widgets/pagespeed-audit-edit.blade.php
packages/seo-suite/resources/views/filament/widgets/partials/pagespeed-audit-edit-content.blade.php
packages/seo-suite/resources/views/filament/widgets/partials/pagespeed-run-audit-button.blade.php
packages/seo-suite/resources/views/filament/widgets/partials/seo-audit-edit-content.blade.php
packages/seo-suite/resources/views/filament/widgets/seo-audit-edit.blade.php
packages/seo-suite/resources/views/filament/widgets/seo-audit-list.blade.php
packages/seo-suite/resources/views/head/social-meta.blade.php
packages/seo-suite/resources/views/livewire/filament/widgets/edit-page-pagespeed-audit-badge.blade.php
packages/seo-suite/resources/views/livewire/filament/widgets/edit-page-seo-audit-badge.blade.php
packages/seo-suite/resources/views/partials/canonical.blade.php
packages/seo-suite/resources/views/partials/social-cards.blade.php

Cache tags

seo-suite

Data Model

Required tables: ai_creator_contexts, ai_creator_sessions, ai_discovery_crawler_rules, ai_discovery_page_profiles, ai_discovery_site_profiles, ai_discovery_snapshots, aeo_pre_publication_captures, aeo_publish_observation_requests, ai_generation_histories, broken_links, page_seo_snapshots, page_speed_audit_results, page_speed_audit_runs, seo_audit_runs, search_console_query_metrics, search_console_url_metrics.
Models: AeoPrePublicationCapture, AeoPublishObservationRequest, AiCreatorContext, AiCreatorSession, AiDiscoveryCrawlerRule, AiDiscoveryPageProfile, AiDiscoverySiteProfile, AiDiscoverySnapshot, BrokenLink, PageSeoSnapshot, PageSpeedAuditResult, PageSpeedAuditRun, SearchConsoleQueryMetric, SearchConsoleUrlMetric, SeoAuditRun.
Core record references in migrations: sites via site_id, languages via language_id, pages via page_id, users via user_id, site domains via site_domain_id.
Migration files: 2026_05_10_190870_01_create_ai_creator_contexts_table.php, 2026_05_10_190870_03_create_ai_creator_sessions_table.php, 2026_05_10_190870_04_create_ai_discovery_crawler_rules_table.php, 2026_05_10_190870_05_create_ai_discovery_page_profiles_table.php, 2026_05_10_190870_06_create_ai_discovery_site_profiles_table.php, 2026_05_10_190870_07_create_ai_discovery_snapshots_table.php, 2026_05_10_190870_08_create_broken_links_table.php, 2026_05_10_190870_09_create_page_seo_snapshots_table.php, 2026_05_10_190870_10_create_search_console_url_metrics_table.php, 2026_05_10_190870_11_create_search_console_query_metrics_table.php, 2026_05_29_000001_create_page_speed_audit_runs_table.php, 2026_05_29_000002_create_page_speed_audit_results_table.php, 2026_07_20_000001_create_aeo_publish_observation_requests_table.php, 2026_07_20_000002_add_execution_to_aeo_publish_observation_requests_table.php, 2026_07_20_000003_create_aeo_pre_publication_captures_table.php, 2026_09_08_000001_create_seo_audit_runs_table.php, 2026_09_29_120000_remove_implicit_timestamp_updates_from_seo_suite.php, 2026_10_04_000001_remove_implicit_timestamp_updates_from_seo_suite.php.
Migration impact: run host migrations through the package install flow before opening package surfaces.
Deletion/retention behaviour: migrations declare cascade-on-delete relationships and null-on-delete relationships; retention is scheduled through capell:seo-suite:prune (daily; declared in the manifest).

Install Impact

Required packages: capell-app/admin, capell-app/ai-orchestrator, capell-app/core, capell-app/discovery-foundation, capell-app/frontend, capell-app/insights, capell-app/site-discovery.
Admin navigation: declares admin-page: AiDiscoveryPageContribution, admin-page: BrokenLinksPageContribution, admin-page: NotFoundUrlsPageContribution, admin-page: SearchRankingsPageContribution, admin-page: SeoAuditPageContribution, admin-page: TranslationCoveragePageContribution; each Filament page or resource controls its own navigation visibility.
Admin/editor extensions: dashboard-widget: SeoSuiteDashboardFilamentWidgetsContribution.
Permissions: View:SeoAuditPage, View:BrokenLinksPage, Manage:BrokenLinks, View:NotFoundUrlsPage, Manage:NotFoundUrls, View:AiDiscoveryPage, Manage:AiDiscovery, View:SearchRankingsPage, View:TranslationCoveragePage, Manage:SeoSuiteSettings, Use:AiCreator; Shield-generated page permissions for Capell\SeoSuite\Filament\Pages\AiDiscoveryPage, Capell\SeoSuite\Filament\Pages\BrokenLinksPage, Capell\SeoSuite\Filament\Pages\NotFoundUrlsPage, Capell\SeoSuite\Filament\Pages\SearchRankingsPage, Capell\SeoSuite\Filament\Pages\SeoAuditPage, Capell\SeoSuite\Filament\Pages\SeoSuiteSettingsPage, Capell\SeoSuite\Filament\Pages\TranslationCoveragePage (names and grants depend on host Shield configuration); access also governed by package policies: AiCreatorPolicy.
Public routes: registers AiDiscoveryRoutesContribution.
Database changes: package migrations are declared.
Config: config/capell-seo-suite.php, config/exchanger.php.
Settings: Capell\AIOrchestrator\Settings\AIOrchestratorSettings, Capell\SeoSuite\Settings\SeoSuiteSettings.
Queues or schedules: scheduled commands capell:seo-suite:aeo-observations (everyMinute; package registered), capell:seo-suite:pagespeed-audit --notify (weeklyOn:1:06:00; manifest declared), capell:seo-suite:prune (daily; manifest declared), capell:seo-suite:refresh-seo-snapshots (dailyAt:02:30; package registered); queue jobs RegenerateLlmsFullTxtJob, RunAeoPublishObservationJob, RunPageSpeedAuditJob, RunSeoAuditJob.
Cache tags: seo-suite.
Commands: capell:admin-clear-ai-cache, capell:admin-monitor-ai-usage, capell:admin-test-openai, capell:seo-suite-doctor, capell:seo-suite-install, capell:seo-suite-setup, capell:seo-suite-sync-search-console, capell:seo-suite:aeo-observations, capell:seo-suite:pagespeed-audit, capell:seo-suite:prune, capell:seo-suite:refresh-ai-discovery-markdown, capell:seo-suite:refresh-seo-snapshots, capell:seo-suite:screenshot-fixture.

Common Pitfalls

Keep required Capell packages on compatible v4 releases: capell-app/admin, capell-app/ai-orchestrator, capell-app/core, capell-app/discovery-foundation, capell-app/frontend, capell-app/insights, capell-app/site-discovery.
Run migrations before opening package resources or public routes.
Review package configuration before production-like verification: config/capell-seo-suite.php, config/exchanger.php, Capell\AIOrchestrator\Settings\AIOrchestratorSettings, Capell\SeoSuite\Settings\SeoSuiteSettings.
Keep the host Laravel scheduler running so package-registered schedules can execute: capell:seo-suite:aeo-observations (everyMinute; package registered), capell:seo-suite:pagespeed-audit --notify (weeklyOn:1:06:00; manifest declared), capell:seo-suite:prune (daily; manifest declared), capell:seo-suite:refresh-seo-snapshots (dailyAt:02:30; package registered).
Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries.
Custom write integrations must preserve invalidation for seo-suite cache tags.

Troubleshooting

Symptom	Likely cause	Check	Fix
Package health check reports a problem	Package configuration or runtime dependencies are not ready	Run `php artisan capell:seo-suite-doctor`	Follow the reported checks, then rerun the doctor command
Package surface is missing after install	Provider or manifest is not loaded	Confirm `capell.json`, package `composer.json`, and provider registration	Reinstall the package, refresh Composer autoload, and clear host caches
Admin screen or command fails on missing table	Package migrations have not run	Check the tables listed in `Data Model`	Run host migrations and rerun the focused package test
Background work does not run	Queue worker or declared schedule is not active	Check the jobs and scheduled commands listed in `Technical Shape`	Start the queue worker or host scheduler, then run the focused command or package test
Public output leaks unexpected state	Render data, cache variation, or authoring boundary has regressed	Check public Blade, cache tags, and public-output safety tests	Move data loading out of Blade and rerun the package public-output tests

Quick Start

Install the package: composer require capell-app/seo-suite.
Run the package setup: php artisan capell:seo-suite-install.
Open the package admin surface at /admin/seo-suite/seo-audit and confirm SEO Suite is available.

Next Steps

Package docs
Overview
Worked extension examples
Admin guide
Configuration files: config/capell-seo-suite.php, config/exchanger.php.
Troubleshooting
Screenshot contract
Marketplace assets
Capell content language plan
Capell documentation design system
Capell and package ERD notes
Related packages: Ai Orchestrator, Discovery Foundation, Insights, Site Discovery, Blog, Publishing Studio, Socials, Url Manager.