Skip to content

feat(observability): structured logger + Effect.fn name rule#881

Draft
RhysSullivan wants to merge 1 commit into
effect/bump-beta66from
effect/observability
Draft

feat(observability): structured logger + Effect.fn name rule#881
RhysSullivan wants to merge 1 commit into
effect/bump-beta66from
effect/observability

Conversation

@RhysSullivan
Copy link
Copy Markdown
Owner

The observability foundation for the Effect standardization stack.

  • Structured logger (@executor-js/sdk/observability): service-annotated, key=value fields, log-span durations, pretty cause. Merged into the local + cli runtimes via Layer.provideMerge.
  • No phone-home: cli/local/desktop ship logging only — no OTLP exporter, nothing leaves the machine. Effect.fn span names stay in-process (named fibers + log context); cloud keeps its own export.
  • effect-source-of-truth skill: grep .reference/effect-smol, don't write Effect from memory (this repo is effect 4 / effect-smol).
  • require-effect-fn-name lint rule (enforced as error): Effect.fn must carry a "Domain.method" string; use Effect.fnUntraced for un-named helpers.
  • Vertical slice: account API handlers named Effect.fn("account.<endpoint>") — the template for the wider tracing sweep.

Stacked on #880 (effect beta.66 bump).

Verified: typecheck (all 38 packages), lint (0/0), format, and sdk/api/local test suites.

Draft — changeset + full e2e to come.

Add a structured, service-annotated logger (`@executor-js/sdk/observability`) and
merge it into the local + cli runtimes via `Layer.provideMerge`. Client apps
(cli/local/desktop) do not phone home: this is logging only, no OTLP exporter —
`Effect.fn` span names stay in-process.

Also:
- add an `effect-source-of-truth` skill (grep `.reference/effect-smol`; don't write
  Effect from memory — this repo is effect 4 / effect-smol).
- add the `require-effect-fn-name` lint rule (`Effect.fn` must carry a string span
  name; use `Effect.fnUntraced` for un-named helpers), enforced as error.
- name the account API handlers `Effect.fn("account.<endpoint>")` as the template
  for the wider tracing sweep.

Verified: typecheck (all 38 packages), lint (0/0), format, sdk/api/local tests.
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Jun 2, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
executor-marketing f3d5262 Commit Preview URL

Branch Preview URL
Jun 02 2026, 06:09 AM

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Jun 2, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
executor-cloud f3d5262 Jun 02 2026, 06:10 AM

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new Bot commented Jun 2, 2026

Open in StackBlitz

@executor-js/cli

npm i https://pkg.pr.new/@executor-js/cli@881

@executor-js/config

npm i https://pkg.pr.new/@executor-js/config@881

@executor-js/execution

npm i https://pkg.pr.new/@executor-js/execution@881

@executor-js/sdk

npm i https://pkg.pr.new/@executor-js/sdk@881

@executor-js/codemode-core

npm i https://pkg.pr.new/@executor-js/codemode-core@881

@executor-js/runtime-quickjs

npm i https://pkg.pr.new/@executor-js/runtime-quickjs@881

@executor-js/plugin-file-secrets

npm i https://pkg.pr.new/@executor-js/plugin-file-secrets@881

@executor-js/plugin-graphql

npm i https://pkg.pr.new/@executor-js/plugin-graphql@881

@executor-js/plugin-keychain

npm i https://pkg.pr.new/@executor-js/plugin-keychain@881

@executor-js/plugin-mcp

npm i https://pkg.pr.new/@executor-js/plugin-mcp@881

@executor-js/plugin-onepassword

npm i https://pkg.pr.new/@executor-js/plugin-onepassword@881

@executor-js/plugin-openapi

npm i https://pkg.pr.new/@executor-js/plugin-openapi@881

executor

npm i https://pkg.pr.new/executor@881

commit: f3d5262

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.

1 participant