# Build the development source candidate

This source is the 2.0.0 development candidate based on the sanitized premium source supplied in the mandate. It has not passed the official Freemius Free/Pro transformation. An installable source ZIP is not a release certificate or a Free-distribution claim.

The PHP runtime is autoloaded by Composer. `composer.lock` fixes Freemius WordPress SDK 2.13.5; its bundled license is preserved. `vue/pnpm-lock.yaml` fixes the settings application's dependencies. Readable sources remain in `vue/src`; `admin/editor` and `admin/ui/library.js` are maintained directly.

From PowerShell in the Git development checkout (the client source ZIP excludes the development scripts below):

```powershell
composer install --no-dev --prefer-dist --no-interaction
Push-Location vue
pnpm install --frozen-lockfile
pnpm run build
Pop-Location
python scripts/build-translations.py
python scripts/build-source-package.py candidate
```

Qualified toolchain: Node 26.12.1, pnpm 12.15.0. The workspace explicitly permits only the locked esbuild 0.28.2, vue-demi 0.14.10 and @parcel/watcher 2.6.0 install scripts; no global pnpm policy is changed.

The settings build writes `admin/ui/index.js` and `index.css`; it preserves the separate library assets. The package script uses fixed timestamps, sorted paths and a per-file SHA256 manifest. It excludes local tests, fixtures, credentials, evidence, Git metadata and node_modules. Two executions from unchanged sources must produce identical archives.

The package records its actual Git HEAD and dirty state. Final qualification must name the exact archive hash. Published Free and Pro artifacts require the official channel transformation and a separate authorized external step, followed by installation and permission/licence tests on the resulting artifacts.

Translation generation runs an AST omission guard over the editor and block sources, using the existing TypeScript dependency installed by the locked Vue setup above. It also uses the PHP CLI (7.4 or later) for a separate token guard restricted to SettingsSchema option labels; normalization keeps untranslated stable values and presentation loads the locale-specific labels. `node tests/ui-translations.test.cjs` checks that untranslated UI mutants are rejected. Gettext extraction coverage counts wrapped messages; it is not exhaustive rendered-language certification. After changing PHP messages, regenerate the POT with `scripts/extract-translations.ps1` in the isolated local WordPress harness before running the catalogue check.

The client source archive retains readable Vue sources and locked inputs, so `pnpm install --frozen-lockfile` and `pnpm run build` in `vue` reproduce the settings assets. Translation extraction, regression tests and package tooling live in the development checkout/review bundle, not the installed client package. `scripts/build-distribution-fixtures.py` produces explicitly simulated exclusion fixtures for local checks only; Freemius official outputs require their own authorized transformation.


## Deletion integration and repository checks

See [the deletion integration notes](docs/mandate/2026-11-02/deletion-integration/IMPLEMENTATION.md) for native review routes, bounded empty-draft cleanup, the resumable per-object private-copy index and database lock requirements. Protected operations require MySQL 5.7.5+ or MariaDB 10.0.2+; this candidate was exercised natively on MariaDB 10.11.19. Other advertised version thresholds are compatibility checks, not native certification.

Run `pwsh -File scripts/test-targeted.ps1` for the isolated regression suites. Run `python -X utf8 scripts/build-translations.py --check` after installing the locked Vue dependencies. Native WordPress/SQL/browser and installed-ZIP evidence are separate. Install the repository-local secret hook with `pwsh -File scripts/install-precommit-hook.ps1` (Gitleaks 8.30.1 must be available).

`release.config.json` is the canonical package allowlist. Build the development source with `python -X utf8 scripts/build-source-package.py LABEL`, then run `scripts/build-distribution-fixtures.py` and `scripts/prepare-release-dry-run.py` to stage explicit local simulations for the pinned native Pagup action. The repository root is Premium development source; passing it directly as an already transformed Free payload is invalid. A green simulation dry-run does not authorize upload, publication or distribution as an official Freemius edition.

Owned text uses LF. Historical mandate evidence and upstream Composer bytes are explicitly excluded from normalization. Major frontend upgrades remain separate from the locked vue-i18n/Sass minor updates.

## Suppression follow-up

See [the focused correction notes](docs/mandate/2026-11-02/suppression-followup/IMPLEMENTATION.md) for DB-COMPAT-01, automatic private-index preparation (N8), and persistent empty-draft cleanup progress (F-N6-01). Native checks now include MySQL 8.4.13 in addition to MariaDB 10.11.19; historical build-comment variants and native server tests are reported separately.
