sync: shared fullstack docs
3150c0b
docs: link same-wiki pages by name instead of by full GitHub URL
Every same-wiki link was written as a full github.com URL. On GitHub the two
forms are identical -- it resolves a bare page name against the wiki it is
rendering -- but this wiki also ships inside the Convert Claude plugin as a
read-only mirror, and there they are not identical at all: a skill routes an
absolute URL to "external", so the page sitting on disk beside it never gets
opened, and the answer is reconstructed instead of read. This repo is private,
so the fetch that would rescue it returns 404.
Cross-wiki links keep their absolute form -- a bare name would resolve inside
this wiki and land on the wrong page. _Sidebar.md and _Footer.md are untouched:
GitHub nav chrome, absolute by convention, on no skill routing path. Anchors are
preserved.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
ab9f7d3
docs(php-sdk): refresh SDK-owned pages against main (556084c..fba2089)
Covers the 79 commits since the last verified watermark, excluding the
287 auto-generated packages/Types/lib/Generated files.
New surface:
- Configuration: debugToken (forced debug_token= + _conv_low_cache=1,
full PSR-16 config-cache bypass, log redaction incl. PSR-18 exception
messages, never sent to the track endpoint); the Comparisons operator
set now that exists/not_exists/doesNotExist landed; the fixed
ConvertAgent/1.0 User-Agent applied after the header merge.
- CodeExamples: Experiment Preview — setPreview(), PreviewParam::parse(),
context-lifetime zero trace, inert-on-bad-input, ?exp= on-demand fetch
memoized 60s under preview_{experienceId}.
- ReturnTypes: SegmentsKeys (visitorType/customSegments rename),
RuleType, ConversionSettingKey, DataStoreQueueReleased.
- Installation: single-package publishing model and the real require set
(PSR interfaces, murmurhash, guzzle/psr7, ext-curl/json/mbstring).
- Testing: cross-SDK parity suite incl. the anchored bucketing golden
vectors (packed version <= 11, anchored version > 11).
- AI_Index/Home: the five shared pages the sync added but nav never got
(qa-and-preview, mutual-exclusion, server-side-experimentation,
from-tracking-script-to-sdk, direct-tracking-endpoint).
Fixes found while verifying against the code:
- LogLevel is int-backed (0-5), not string-backed.
- Core::on() takes a string; SystemEvents::Ready throws a TypeError.
Every event example unwrapped with ->value.
- PSR-18 discovery is Psr18ClientDiscovery::find(), not
HttpClientDiscovery::find().
- SegmentsManager rewritten: dropped the "Chapter 10" framing and six
links to pages deleted in April, replaced excerpts that described an
algorithm the class does not implement, and corrected the
runCustomSegments example to nest rule data under ruleData.
- Documented that Segments/Audiences/DataStoreQueueReleased are never
emitted, and that once one custom segment matches, the rest in the
same call are accepted without evaluating their own rule trees.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
8c28276
sync: shared fullstack docs
e913b09
sync: shared fullstack docs
c7a3fce
sync: shared fullstack docs
5cb7e34
sync: shared fullstack docs
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
6da1cf5
sync: shared fullstack docs (PHP-specific Step 4 screenshot, fix prior incomplete sync)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4ae35cc
sync: shared fullstack docs (per-SDK PHP variant for Step 4 screenshot)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
750e4d3
sync: shared fullstack docs
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3547000
sync: shared fullstack docs
cef4877
sync: shared fullstack docs (PHP code blocks only)
Propagates changes from the canonical source at
backend/public/js/tracking/full-stack-docs/:
- data-management.md gains the new "Audience Evaluation Cadence" section
- api-communication.md fixes [DataManager] links to point at
data-management (was data-model)
- quickstart-overview.md and persistent-datastore.md now produce correct
cross-SDK wiki URLs via the updated sync-docs.js link rewriter
- how-convert-works.md, quickstart-overview.md, troubleshooting.md pick
up canonical edits that had drifted since the last PHP sync run
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
9b3351a
docs: fix AI_Index canonical-source path, add CLAUDE.md for shared-docs guard rails
AI_Index.md previously described the shared-docs canonical source as
"../backend.wiki/" and linked to a fabricated github.com URL. Corrected
to name the real canonical path within the backend repo and describe
(not link) the private source.
Added CLAUDE.md at the wiki root documenting: (a) the shared vs
PHP-specific page split and decision rule before editing, and (b) the
writing rules for shared docs — never reference the private backend
wiki or its filesystem paths, never invent URLs, prefer package + class
+ method references over file:line.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
9e6ab41
docs: reflect single-package publishing model (qs-11)
a8a490a
sync: shared fullstack docs (PHP code blocks only)
Synced from backend with --keep-lang php. JS/TS code blocks stripped.
Cloudflare Workers and LLM Testing pages removed (JS-only).
Edge & Integrations section removed from navigation.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
5d145d3
docs: add AI_Index.md for refactored wiki structure
Add AI agent routing index reflecting the shared/SDK-specific page
layout after the module page consolidation.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
8d5140a
refactor: remove old module pages, update navigation to shared docs
Remove duplicate CamelCase pages (Core, Context, ExperienceManager,
etc.) now replaced by shared docs synced from backend. Update Home
and Sidebar to link to the new canonical pages.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
4346c53
sync: shared fullstack docs
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
8e0db2c
sync: shared fullstack docs
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
72cd070
sync: shared fullstack docs
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
a25e047
sync: shared fullstack docs
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
99a8d75
fix: add source repo link to Installation, remove Changelog
Changelog is synced via rdme to readme.io directly, not through the wiki.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
3477567
fix: update titles, remove MDX welcome page (not compatible with GitHub wiki)
- Rename: Full Stack Method, Architecture, Quickstarts, Requirements
- Remove welcome.md (MDX Cards don't render on GitHub wiki; use Home.md instead)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
b33a08e
feat: add shared fullstack docs synced from backend repo
- 22 shared concept, guide, and integration docs (flattened, no frontmatter)
- Cross-links rewritten for GitHub wiki URLs
- Source: backend/public/js/tracking/full-stack-docs/
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
b03e147
feat: add language-specific SDK reference docs
- Add Quickstart, Installation, Initialization, Configuration, CodeExamples, ReturnTypes, Testing, Changelog
- Add sdk-docs-config.json for Readme.io frontmatter mapping
- Shared concept docs will be synced from backend repo via CI
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
a14d476
docs: update wiki for array-based logger config, new SDK defaults
Reflects current SDK state: logger config uses logLevel/customLoggers
array pattern, adds bucketing.excludeExperienceIdHash,
rules.negation, and network.source to documented defaults.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
fb28747
docs: add complete PHP SDK wiki documentation
Create full wiki matching the JavaScript SDK wiki structure and style,
adapted for PHP's request-scoped execution model and PSR standards.
17 files covering:
- Home page with architecture diagram and JS SDK differences
- 11 chapters: Core, Context, ExperienceManager, FeatureManager,
DataManager, BucketingManager, RuleManager, ApiManager, EventManager,
SegmentsManager, Config/Types
- User Guide with full API reference
- Data Model Reference with entity relationships
- AI Index, Sidebar, and Footer navigation
Key PHP-specific adaptations documented:
- Synchronous ConvertSDK::create() static factory
- PSR-3/16/18 integration (logging, caching, HTTP)
- PSR-16 cache as dual-purpose config + visitor data store
- No timeouts/timers — register_shutdown_function for queue flush
- Simplified DataStoreManager (clean passthrough, no queue)
- Readonly DTOs and backed PHP enums
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
605b107