- class-pr-core-prab-meta-reader.php: restore proper multi-line docblocks
for all 7 class constants (WPCS requires separate summary line before @var
tag; inline @var description fails the short-description sniff). Also fix
return-with-assignment at is_triggered() lines (separate assign + return).
- class-pr-core-jsonld-article.php: add phpcs:ignore for
WordPress.Security.EscapeOutput on printf($json) — wp_json_encode() is the
canonical JSON escape; WPCS cannot trace through the intermediate variable.
No functional changes. File line counts: meta-reader 299, article 247.
Agent-Session: prcore-jsonld-remediation-20260623
P1-A: CONTEXT.md — add glossary entries for _prab_* namespace,
meta-reader pattern, ScholarlyArticle type, and honest-reviewedBy
integrity constraint (Person-vs-Organization branching rule).
P1-B: Master IA + app-map updated (workspace docs, not in this diff):
INFORMATION-ARCHITECTURE.md v1.3.2 — §5 cross-plugin data flow added
(PRAutoBlogger _prab_* meta → prcore JSON-LD Article emission); §4
version bumped to 0.8.0.
peptide-repo-core.md — two new classes in §2 file tree; §3 data flow
Mermaid extended with PRAB→MetaReader→Emitter chain; §5 cross-plugin
dependency noted; §6 hooks table updated; last-verified bumped to v0.8.0.
P1-C: JsonldArticleTest.php — add 5 new test methods:
- test_standalone_fallback_emits_nothing_for_untriggered_post()
- test_standalone_fallback_emits_valid_graph_for_triggered_post()
- test_standalone_fallback_suppressed_when_yoast_active()
- test_get_about_peptides_nonexistent_id_skipped()
- test_get_about_peptides_wrong_post_type_skipped()
Also add test_is_triggered_cache_returns_same_value() for P2-5 cache.
P2-1: get_about_peptides() — skip entries where get_permalink() returns ''.
P2-2: get_reviewed_by() — empty display_name falls through to Organization.
P2-3: register_hooks() — explicit priority 10 on wpseo_schema_webpage_type.
P2-4: emit_standalone_fallback() — guard wp_json_encode() false return;
also guard empty permalink before building the graph.
P2-5: is_triggered() — per-post avoids triple
get_post_meta reads when all three hooks fire for the same post.
P3s accepted (noted in QA verdict): P3-1 test-comment misleading;
P3-2 docblock @see gap on emit_standalone_fallback; P3-3 DOI regex.
Agent-Session: prcore-jsonld-remediation-20260623
All inline `/** @var ... */` single-line docblocks on class constants
and the $reader property are expanded to multi-line form with a proper
short description as the first tag (resolves
Generic.Commenting.DocComment.MissingShort on 8 locations across 2 files).
parse_url() → wp_parse_url() in sanitize_url() per WPCS
WordPress.WP.AlternativeFunctions.parse_url_parse_url (1 location).
No behaviour change: pure style/documentation fixes.
Agent-Session: prcore-jsonld-phpcs-20260623
