Skip to content

feat: v0.23.0 — meta line, startup refresh, README rewrite#3

Merged
Nathan Schram (nathanschram) merged 4 commits intomasterfrom
feature/v0.23.0-readme-refresh
Feb 26, 2026
Merged

feat: v0.23.0 — meta line, startup refresh, README rewrite#3
Nathan Schram (nathanschram) merged 4 commits intomasterfrom
feature/v0.23.0-readme-refresh

Conversation

@nathanschram
Copy link
Copy Markdown
Member

Summary

  • Model and mode metadata footer — every completed message shows 🏷 sonnet · plan across all 4 engines (Claude, Codex, OpenCode, Pi)
  • Startup message refresh — compact format with version number, project count, conditional diagnostics (only shows mode/topics/triggers/engines when they carry signal)
  • README rewrite — pitchdocs-style hero, compact bullet-list features, accurate permissions description, new intro for newcomers
  • llms.txt + llms-full.txt — AI discoverability following llmstxt.org spec (index + 6k lines of full docs)
  • Docs updated — changelog v0.23.0, spec bumped, all 4 engine event mapping docs updated with meta field documentation
  • Version bump — 0.22.2 → 0.23.0

Test plan

  • ruff format --check — 203 files formatted
  • ruff check — all passed
  • ty check — 11 pre-existing warn-level diagnostics (all --warn in CI config)
  • pytest — 861 passed, 80.82% coverage (above 80% threshold)
  • uv build — wheel + sdist for 0.23.0 built
  • uv lock --check — lockfile in sync
  • bandit — 0 security issues
  • pip-audit — no vulnerabilities

🤖 Generated with Claude Code

Add model/mode metadata footer to completed messages across all engines.
Refresh README with accurate permissions description, voice notes and
metadata subsections, punchier "Why Untether?" table, and warmer
Contributing section. Bump version to 0.23.0.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ions

Adopt pitchdocs hero pattern: bold descriptor, compatibility line with
engine links, quick nav links. Rewrite intro for newcomers with zero
context. Move Features directly after Quick Start. Remove "Why Untether?"
table (value prop now covered by hero + features). Add LBA footer.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Collapse Features from ### subheadings to bold+em-dash bullet list for
better scannability. Merge "More features" into the same list. Move
conversation modes to final bullet. Remove non-existent Telegram group
link from Contributing.

Add llms.txt (index) and llms-full.txt (6k lines) following the
llmstxt.org spec for AI discoverability.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- CHANGELOG: mark unreleased as v0.23.0 (2026-02-26)
- Specification: bump version to v0.23.0
- Claude runner.md: add model to meta field list
- Claude untether-events.md: document meta.model and meta.permissionMode
  extraction from system.init
- Codex untether-events.md: update StartedEvent example to show meta.model
  from run options (not raw debug blob)
- OpenCode untether-events.md: document meta.model from runner config
- Pi untether-events.md: document meta.model and meta.provider from config
- Regenerate llms-full.txt with updated docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@nathanschram Nathan Schram (nathanschram) merged commit 80ab5ad into master Feb 26, 2026
17 checks passed
@nathanschram Nathan Schram (nathanschram) deleted the feature/v0.23.0-readme-refresh branch February 26, 2026 05:13
Nathan Schram (nathanschram) added a commit that referenced this pull request Mar 10, 2026
…sions

- Add CodeQL code scanning workflow (Python + Actions) on push, PRs, and weekly schedule
- Add Dependabot config for weekly github-actions and pip dependency updates
- Add permissions: {} to notify-website.yml (resolves code scanning alert #1)
- Update CLAUDE.md CI pipeline table with CodeQL entry

Also configured via GitHub API (not in this commit):
- Repo ruleset "CI Required Checks" requiring all 14 CI checks to pass before merge
- Secret scanning AI detection enabled
- Code scanning alerts #2 and #3 dismissed as "used in tests" (false positives)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Nathan Schram (nathanschram) added a commit that referenced this pull request Apr 15, 2026
…rs, runner, telegram, docs

CodeRabbit flagged 1 critical + 15 major + 4 outside-diff issues during
review of the v0.35.1 release PR. After triage, 15 are real bugs worth
fixing before release; 3 are false positives and 2 are deferred.

P0 — Critical functional regressions in v0.35.1 features:
- triggers/cron.py: daily/weekly crons stop after first day. last_fired
  was keyed by (hour, minute) only, so tomorrow's 09:00 looked identical
  to today's and got suppressed forever. Now keyed by full date+time. (#11)
- runner_bridge.py: tree_active subagent runs were force-killed at
  STALL_MAX_WARNINGS because the auto-cancel exemption only checked
  cpu_active. Now exempts tree_active when active children present. (#4)
- triggers/actions.py: append_timestamp on_conflict used second-resolution
  names so two requests in the same second clobbered each other (the
  feature is meant to PREVENT that). Now uses time.time_ns() with a
  collision probe loop. (#9)

P1 — Functional bugs in supporting features:
- runners/claude.py: _PLAN_EXIT_APPROVED was only set in interactive
  approval. Auto-approve drain (auto permission mode + post-discuss
  approval) skipped the bookkeeping, defeating #283 in those flows. (#5)
- telegram/parsing.py: offset was persisted before yield, so a crash
  between yield and consumer could record an unprocessed update as done.
  Now persists after yield. (#8)
- triggers/rate_limit.py: per-hit warning logs flooded structured output
  and fed the issue watcher. Dropped to debug. (#16)
- telegram/commands/config.py: reasoning levels weren't validated against
  engine support — manual callback_data could persist e.g. `max` on
  Codex. Defensive validation added. (#20)
- telegram/bridge.py: docstring claimed chat_ids was hot-reloadable but
  it's never sourced from settings. Corrected docstring (#6).

P2 — Doc/display quality:
- triggers/describe.py: invalid DOW values were normalised via % 7 (8 →
  Mon); stepped patterns like */2 in dom/mon were rendered as "daily"
  due to substring check. Both now fall back to raw schedule. (#13, #14)
- config.py: rs:max action had no toast entry. Added. (#19)
- README.md: access matrix overstated isolation, omitted /file put,
  outbox, and webhook file_write/http_forward actions. Now accurate. (#3)
- docs/reference/integration-testing.md: bot ID was reused as DM chat
  ID. Clarified that DM target is the user's chat ID. (#1)
- docs/reference/specification.md: header said v0.35.1 but body said
  "Untether v0.35.0 specifies:". Synced to v0.35.1. (#17)
- tests/test_claude_control.py: cleanup fixture only ran post-yield.
  Now runs pre- and post-yield. (#18)

Skipped (false positives or out of scope):
- #2 (version bump suggestion): user decision, not auto-applicable.
- #7 (restart-only keys hot-reloaded): false positive — update_from is
  selective and only touches hot fields.
- #12 (cron snapshot): false positive — remove_cron replaces the list,
  doesn't mutate in place.

Deferred to follow-up issues:
- #10 (Content-Type override on http_forward raw bodies)
- #15 (duplicate cron ID/webhook path validation)

Test additions:
- test_trigger_cron.py: regression test for daily cron firing on
  consecutive days (covers #11)
- test_describe_cron.py: 6 regression tests for #13/#14 fallback paths
- test_config_command.py: split per-engine reasoning level test +
  regression test for codex/rs:max rejection (covers #20)
- test_claude_control.py: clarified pre/post-yield cleanup (covers #18)

Verified: 2172 tests pass (was 2164, +8 new), 81.51% coverage,
ruff format/lint clean, build successful.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Nathan Schram (nathanschram) added a commit that referenced this pull request Apr 15, 2026
…rs, runner, telegram, docs (#311)

CodeRabbit flagged 1 critical + 15 major + 4 outside-diff issues during
review of the v0.35.1 release PR. After triage, 15 are real bugs worth
fixing before release; 3 are false positives and 2 are deferred.

P0 — Critical functional regressions in v0.35.1 features:
- triggers/cron.py: daily/weekly crons stop after first day. last_fired
  was keyed by (hour, minute) only, so tomorrow's 09:00 looked identical
  to today's and got suppressed forever. Now keyed by full date+time. (#11)
- runner_bridge.py: tree_active subagent runs were force-killed at
  STALL_MAX_WARNINGS because the auto-cancel exemption only checked
  cpu_active. Now exempts tree_active when active children present. (#4)
- triggers/actions.py: append_timestamp on_conflict used second-resolution
  names so two requests in the same second clobbered each other (the
  feature is meant to PREVENT that). Now uses time.time_ns() with a
  collision probe loop. (#9)

P1 — Functional bugs in supporting features:
- runners/claude.py: _PLAN_EXIT_APPROVED was only set in interactive
  approval. Auto-approve drain (auto permission mode + post-discuss
  approval) skipped the bookkeeping, defeating #283 in those flows. (#5)
- telegram/parsing.py: offset was persisted before yield, so a crash
  between yield and consumer could record an unprocessed update as done.
  Now persists after yield. (#8)
- triggers/rate_limit.py: per-hit warning logs flooded structured output
  and fed the issue watcher. Dropped to debug. (#16)
- telegram/commands/config.py: reasoning levels weren't validated against
  engine support — manual callback_data could persist e.g. `max` on
  Codex. Defensive validation added. (#20)
- telegram/bridge.py: docstring claimed chat_ids was hot-reloadable but
  it's never sourced from settings. Corrected docstring (#6).

P2 — Doc/display quality:
- triggers/describe.py: invalid DOW values were normalised via % 7 (8 →
  Mon); stepped patterns like */2 in dom/mon were rendered as "daily"
  due to substring check. Both now fall back to raw schedule. (#13, #14)
- config.py: rs:max action had no toast entry. Added. (#19)
- README.md: access matrix overstated isolation, omitted /file put,
  outbox, and webhook file_write/http_forward actions. Now accurate. (#3)
- docs/reference/integration-testing.md: bot ID was reused as DM chat
  ID. Clarified that DM target is the user's chat ID. (#1)
- docs/reference/specification.md: header said v0.35.1 but body said
  "Untether v0.35.0 specifies:". Synced to v0.35.1. (#17)
- tests/test_claude_control.py: cleanup fixture only ran post-yield.
  Now runs pre- and post-yield. (#18)

Skipped (false positives or out of scope):
- #2 (version bump suggestion): user decision, not auto-applicable.
- #7 (restart-only keys hot-reloaded): false positive — update_from is
  selective and only touches hot fields.
- #12 (cron snapshot): false positive — remove_cron replaces the list,
  doesn't mutate in place.

Deferred to follow-up issues:
- #10 (Content-Type override on http_forward raw bodies)
- #15 (duplicate cron ID/webhook path validation)

Test additions:
- test_trigger_cron.py: regression test for daily cron firing on
  consecutive days (covers #11)
- test_describe_cron.py: 6 regression tests for #13/#14 fallback paths
- test_config_command.py: split per-engine reasoning level test +
  regression test for codex/rs:max rejection (covers #20)
- test_claude_control.py: clarified pre/post-yield cleanup (covers #18)

Verified: 2172 tests pass (was 2164, +8 new), 81.51% coverage,
ruff format/lint clean, build successful.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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