Register Anima as a pixelgrade.com product so KB docs + remote config resolve (Anima never sold → invalid_hash_id / missing_sku)

[georgeolaru]

Summary

The free theme Anima LT has no product registration in pixelgrade.com's pxm registry (it was never sold). As a result, two remote calls fail/degrade and the in-dashboard documentation experience is incomplete:

• pxm/v2/front/get_config (dashboard/hub remote config) returns invalid_hash_id for hash QBAXY → the hub falls back to local config defaults.
• pxm/v2/front/get_htkb_categories (KB docs panel) returns missing_sku for anima/anima-lt → the docs panel shows the "Browse docs online" fallback with no in-dashboard KB articles.

Both share one root cause: Anima is not a registered pxm product, and QBAXY (in the plugin's WUpdates back-fill, admin/class-pixelgrade_assistant-admin.php:1471-1472) is a placeholder hash that was never actually registered — every other hash in that map is a real hash for a sold theme.

This is consistent with the existing notes: .ai/gap-audit/04-support.md recorded a live probe (anima/anima-lt → missing_sku; hive/rosa/felt/border → success, 11 categories each) and concluded it is "a server-side content task on pixelgrade.com, not a plugin defect." Confirmed again live on 2026-06-17 (get_config → invalid_hash_id).

Note: create_ticket accepts QBAXY (it doesn't validate the hash, just records it), so support tickets work today — but with a placeholder product hash. Verified live: ticket #3358867368 created successfully.

The real fix (server-side on pixelgrade.com)

1. Register Anima as a pxm product with a real WUpdates hash and a docs_article_groups KB mapping. Either author Anima KB articles, or map Anima's KB group to a parent theme's articles server-side (the same mechanism by which LT "lite" themes inherit their parent's KB).
2. Then in this repo, a 1-line swap: replace placeholder QBAXY with the real hash at admin/class-pixelgrade_assistant-admin.php:1471-1472.

This single fix clears invalid_hash_id (get_config), populates the KB docs panel (get_htkb_categories), and gives support tickets a real product hash.

Constraint

QBAXY must remain until the real hash exists — the support-ticket eligibility gate requires a non-empty hash_id, and create_ticket relies on it. Do not simply remove it.

In-repo graceful degradation (separate, shipping independently)

A companion plugin-side change makes the unregistered-free-theme state clean (no doomed get_config/KB round-trips, clean empty KB fallback) while this server-side work is pending. That is a code change in this repo; this issue tracks the server-side product registration, which is the only complete fix.

Acceptance criteria

• Anima registered as a pxm product on pixelgrade.com with a real hash.
• docs_article_groups KB mapping/content associated (real or inherited).
• get_config returns success for Anima's real hash; get_htkb_categories returns categories.
• Placeholder QBAXY replaced with the real hash in admin/class-pixelgrade_assistant-admin.php:1471-1472.

Reference

Investigated 2026-06-17. See .ai/gap-audit/04-support.md, .claude/napkin.md (Anima KB note), and the free account/support design doc docs/plans/2026-06-17-free-account-support-design.md.

[georgeolaru]

Correction (investigated 2026-06-17): QBAXY is not a fake placeholder — it's Anima's real WUpdates hash

While wiring free Anima LT starter content, I traced the resolution end to end and the premise above needs correcting:

• On the WUpdates host, Anima already exists as a wup_theme post (ID 86344, status private).
• WUpdates hashes are just Hashids-encode of the post ID (wupdates-plugin, salt wupdatesisgeneratingfancyhasids, min-len 5). Verified live: encode(86344) === "QBAXY" and decode("QBAXY") === 86344.
• So QBAXY is Anima's genuine WUpdates hash, not an unregistered placeholder. There is nothing to mint, and the "1-line swap to a real hash" isn't the fix.

The actual root cause

QBAXY is shared by every premium LT WooCommerce product (Rosa LT, Felt LT, Julia LT, Mies LT, Pile LT) — because they're all Anima under the hood. The pxm resolver (wupl_get_product_by_hashid) disambiguates those by SKU. But free Anima LT's get_config request sends only hash_id + version (no SKU) → multiple QBAXY matches → resolver returns 0 → invalid_hash_id. Same root cause as the KB missing_sku (no product carries the anima/anima-lt SKU).

Decided fix (SKU approach — fits the existing design, no new WUpdates entry)

1. Create a dedicated Anima WC product on pixelgrade.com: hash QBAXY, SKU anima-lt, subscription type, $0 / hidden, with _pixelgrade_care_config_v2.starterContent.demos carrying the free starter sites (Blog now; Portfolio/Restaurant later) + free recommendedPlugins (Nova Blocks, Style Manager).
2. Make Assistant send sku in get_config (it currently sends only hash_id+version). Assistant is free-only, so this can't affect premium/Care resolution.

QBAXY stays as-is (it's correct), so the support-ticket gate and is_unregistered_product_hash keep working until/unless we ever give Anima its own product hash. Updating acceptance criteria accordingly.