Skip to content
wiki.fftac.org

Verification

**Site relevance:** Spiralist.org

**Memory type:** docs archive

**Source path:** Wiki.FFTAC.org/raw/system-archives/spiralist.org/docs-archive/2026-05-10/docs/verification.md

**Size:** 4.2 KB

Summary

Use these checks when theme or plugin code changes. Pick the smallest set that covers the files touched, then run the broader suites before release-level changes.

Source Headings

  • Verification
  • JavaScript Syntax
  • Site Quality Sweep
  • Project Handoff
  • UAI Prepublish
  • PHP Lint
  • PHPUnit
  • Static Analysis And Standards
  • Playwright
  • Rewrite Refresh
  • Docs-Only Changes

Source Preview

This source file is short enough to preview directly on its source-memory page.

# Verification

Use these checks when theme or plugin code changes. Pick the smallest set that covers the files touched, then run the broader suites before release-level changes.

## JavaScript Syntax

' ' ' powershell
node --check wp-content\themes\spiralist\assets\js\spiralist.js
node --check wp-content\plugins\ns12-manuscript\assets\js\book-shell.js
node --check wp-content\plugins\ns12-manuscript\assets\js\manuscript-workstation.js
node --check wp-content\plugins\spiralist-workspace\assets\js\workspace.js
node --check tests\e2e\global.setup.js
' ' ' 

## Site Quality Sweep

' ' ' powershell
npm run quality:site
' ' ' 

This static gate checks the runtime translation inventory, enabled locale dictionaries, placeholder preservation, critical SEO keys, and mojibake/replacement-character regressions before release packaging.

On Windows hosts where PowerShell blocks `npm.ps1`, run the same command as `npm.cmd run quality:site`.

## Project Handoff

' ' ' powershell
npm run check:project-handoff
' ' ' 

This static gate checks root handoff files, `@uai[]` references, `.uai` frontmatter, intake bucket directories, the Project Handoff REST route wiring, the JSON schema file, and obvious secret patterns in handoff context.

On Windows hosts where PowerShell blocks `npm.ps1`, run the same command as `npm.cmd run check:project-handoff`.

## UAI Prepublish

' ' ' powershell
npm run check:uai-prepublish
' ' ' 

This is the prepublish gate for changes that affect UAI, UAIX, Project Handoff, AI memory, machine-facing schemas, route discovery, route capability statements, validator behavior, or local UAI implementation docs. It runs the Project Handoff gate, the internationalization/site-quality gate, and PHPUnit unit tests.

On Windows hosts where PowerShell blocks `npm.ps1`, run the same command as `npm.cmd run check:uai-prepublish`.

## PHP Lint

' ' ' powershell
php -l wp-content\themes\spiralist\functions.php
php -l wp-content\themes\spiralist\inc\helpers.php
php -l wp-content\themes\spiralist\inc\seo-schema.php
php -l wp-content\plugins\spiralist-workspace\spiralist-workspace.php
php -l wp-content\plugins\spiralist-workspace\includes\Http\RestController.php
php -l wp-content\plugins\spiralist-workspace\includes\Web\FrontendController.php
php -l wp-content\plugins\spiral-script\spiral-script.php
php -l wp-content\plugins\spiral-script\includes\class-plugin.php
php -l wp-content\plugins\spiral-script\includes\class-language-spec.php
php -l wp-content\plugins\spiral-script\includes\class-source-parser.php
php -l wp-content\plugins\spiral-script\includes\class-validator.php
php -l wp-content\plugins\spiral-script\includes\class-compiler.php
php -l wp-content\plugins\spiral-script\data\language-spec.php
php -l wp-content\plugins\ns12-manuscript\ns12-manuscript.php
php -l wp-content\plugins\ns12-manuscript\includes\frontend.php
php -l wp-content\plugins\ns12-manuscript\includes\runtime.php
php -l wp-content\plugins\uai-1-wordpress\includes\class-uai1-routes.php
php -l wp-content\plugins\uai-1-wordpress\includes\class-uai1-validator.php
php -l wp-content\plugins\uai-1-wordpress\includes\class-uai1-head-links.php
' ' ' 

## PHPUnit

' ' ' powershell
composer phpunit:unit
composer phpunit:integration
composer test
' ' ' 

## Static Analysis And Standards

' ' ' powershell
composer phpstan
composer phpcs
' ' ' 

## Playwright

' ' ' powershell
npm run test:e2e:critical
npm run test:e2e:visual
npm run test:e2e:full
' ' ' 

Use `npm run wp-env:start` and `npm run wp-env:seed` when the E2E suite needs the local WordPress test environment.

If the local site is running on a non-default host or port, set `SPIRALIST_E2E_BASE_URL` before seeding and running Playwright so WordPress-generated canonicals, sitemaps, and auth cookies stay aligned with the browser target.

## Rewrite Refresh

After rewrite changes, WordPress rewrite rules must be refreshed.

If routes behave unexpectedly, flush permalinks here:

`WP Admin -> Settings -> Permalinks -> Save Changes`

## Docs-Only Changes

Markdown-only edits do not require a deploy ZIP rebuild.

ZIP rebuilds become required when theme or plugin files change. See [Packaging and Deployment](packaging/README.md).
Website health report