release: 0.0.11

[anilcancakir]

Minor feature release for a 0.0.x package: the host redactor hook, a rotating JSONL file sink, and cursor reads with --follow (#43). One breaking change, to a nullable return.

What ships

• Host redactor hook (feat: redact records at insert, a JSONL timeline sink, and cursor reads with --follow #43). TelescopeRedaction.redactor is a host-set String Function(String) applied at insert to every log, event, exception and HTTP record, payload keys included, before the record reaches a queue or a stream.
  • A throwing redactor drops the record.
  • redacted is read-only and set only by the store's redaction pass.
  • Event payloads are made JSON-safe at record time.
• Per-kind capacity. TelescopeStore.setCapacity(int, {TelescopeKind? kind}). LogRecordEntry.atUs puts log lines on the same monotonic clock as events.
• TelescopeFileSink. Rotating JSONL, bounded by bytes and file count.
  • It writes only redacted records and counts the rest.
  • It lists and reads earlier launches by name match only (no path built from input, no symlinks).
  • It halts on a write failure instead of looping on its own exception.
• Reads. ext.telescope.events and ext.telescope.console take since, type and logger and answer a cursor; with since the page is the oldest records after it, extended over ties, so cursor paging is gapless. New ext.telescope.files and ext.telescope.file.
• CLI. telescope:events and telescope:tail gain --since, --type / --logger, --json and --follow. New telescope:files. followCursor is exported from cli.dart.
• Fixes. An unknown console level matched everything (now nothing); a non-positive limit threw (now returns nothing); a non-encodable payload failed the whole events response.
• Breaking. TelescopeRedaction.redactHttpRecord now returns HttpRequestRecord?, null when the redactor throws; a caller outside the store adds a null check. Marked BREAKING in the CHANGELOG. The record constructors take no redacted argument, but no released version had one, so no consumer is affected by that.

Floors

None. fluttersdk_artisan stays ^0.0.19, which is the latest on pub.dev.

Stamps

Site	From	To
pubspec.yaml, server.json, example/pubspec.yaml	0.0.10	0.0.11
example/pubspec.lock	0.0.10	0.0.11, artisan 0.0.19 hosted, no /Users/ path
skills/fluttersdk-telescope/SKILL.md frontmatter and body stamp	0.0.10	0.0.11 (2026-10-10)
CHANGELOG	[Unreleased]	[0.0.11] - 2026-10-10, fresh empty [Unreleased], --- between sections

git grep -nF 0.0.10 -- ':!CHANGELOG.md' ':!*.lock' is empty.

Downstream

magic_devtools and magic's installer can re-pin fluttersdk_telescope: ^0.0.11 in a later batch. Watchools will raise its caret.

Gates

Run with no pubspec_overrides.yaml, against hosted artisan 0.0.19.

• dart format --output=none --set-exit-if-changed lib/ test/ bin/: 74 files, 0 changed.
• dart analyze lib test bin: no issues.
• flutter test --exclude-tags=integration --timeout=30s: +509, all passed.
• flutter pub publish --dry-run: 0 warnings.

Tag

git tag 0.0.11 <merge-oid> && git push origin 0.0.11

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!