Skip to content

chore: native Langfuse example + docs-check on every PR#359

Merged
gloryfromca merged 3 commits into
mainfrom
ci/docs-run-on-all-prs
Jul 24, 2026
Merged

chore: native Langfuse example + docs-check on every PR#359
gloryfromca merged 3 commits into
mainfrom
ci/docs-run-on-all-prs

Conversation

@gloryfromca

@gloryfromca gloryfromca commented Jul 24, 2026

Copy link
Copy Markdown
Collaborator

Pre-release cleanup, two independent changes:

1. Docs check runs on every PR (fixes a merge-blocking CI gate)

The Docs workflow's links job is a required status check but was paths:-filtered to markdown/docs files. A code-only PR never triggered it, so the required check never reported and the merge box sat BLOCKED forever (this stalled #353 with everything else green). Dropping the paths: filter makes make docs-check (relative-link + contributor-doc + template YAML validation) report on every PR — it scans the whole doc tree independent of the diff and runs in seconds.

2. Replace the Langfuse wrapper example with a native one

examples/langfuse/everos_langfuse.py was the interim client-side instrumentation wrapper from before EverOS had native OpenTelemetry export. Now that [observability] emits real OTLP spans, the wrapper is redundant and its mock-faked child spans could mislead. Replaced with a minimal, dependency-light example: enable [observability] in everos.toml, run the server, and demo.py (stdlib only) drives one add/flush/search cycle so native traces show up in Langfuse.

🤖 Generated with Claude Code

@gloryfromca
gloryfromca force-pushed the ci/docs-run-on-all-prs branch from 5dddb81 to c189e50 Compare July 24, 2026 08:11
@gloryfromca gloryfromca changed the title ci(docs): run docs check on every PR so the required check always reports ci(docs): run docs check on every PR so its required check reports Jul 24, 2026
The Docs workflow (`links` job) is a required status check, but its
trigger was `paths:`-filtered to markdown/docs files. A PR touching only
code never triggered it, so the required check never reported and the merge
box stayed BLOCKED forever waiting for a status that would never arrive.

Drop the `paths:` filter: `make docs-check` validates the whole doc tree
independent of the PR diff and runs in seconds, so it is cheap to report on
every PR.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@gloryfromca
gloryfromca force-pushed the ci/docs-run-on-all-prs branch from c189e50 to e85db90 Compare July 24, 2026 08:13
The examples/langfuse wrapper (everos_langfuse.py) was the interim client-side
instrumentation before EverOS gained native OpenTelemetry export. Now that
[observability] emits real OTLP spans, the wrapper is redundant and its faked
child spans could mislead. Replace it with a minimal, dependency-light example:
enable [observability] in everos.toml, run the server, and drive one
add/flush/search cycle (demo.py, stdlib only) to see native traces in Langfuse.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@gloryfromca gloryfromca changed the title ci(docs): run docs check on every PR so its required check reports chore: native Langfuse example + docs-check on every PR Jul 24, 2026
@gloryfromca
gloryfromca merged commit b54e197 into main Jul 24, 2026
9 checks passed
@gloryfromca
gloryfromca deleted the ci/docs-run-on-all-prs branch July 24, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants