Skip to content

docs: pre-1.0 patch judgement note + Pi model footer matrix fix#469

Open
Nathan Schram (nathanschram) wants to merge 3 commits intodevfrom
feature/pi-roadmap-and-doc-fixes
Open

docs: pre-1.0 patch judgement note + Pi model footer matrix fix#469
Nathan Schram (nathanschram) wants to merge 3 commits intodevfrom
feature/pi-roadmap-and-doc-fixes

Conversation

@nathanschram
Copy link
Copy Markdown
Member

Summary

  • Add Pre-1.0 minor judgement paragraph to .claude/rules/release-discipline.md clarifying when opt-in additive features can ship in patches vs minors. Codifies precedent already in use (#409 shipped a config addition in a patch).
  • Fix engine compatibility matrix in README.md: Pi Model in footer cell changes from to ✅⁷ with footnote 7 explaining the supplementary StartedEvent mechanism. Code at src/untether/runners/pi.py:290-307 already does this (since #225); the matrix was stale.

Why

Both fixes surfaced during the Pi engine audit that produced the upcoming roadmap:

The judgement-note edit removes ambiguity for the v0.35.8 RPC runner decision (#170). The matrix fix is a pure code-doc reconciliation — no functional change.

Test plan

  • No code changed — docs only
  • Format: git diff --stat → 2 files, 4 insertions, 1 deletion
  • Local lint (skipped — no Python/code files touched)

Notes

🤖 Generated with Claude Code

All 9 v0.35.3 Group 2 issues now landed on dev:

- #404 — secret-scanning alert (PR #439)
- #297 — /trigger → /listen rename + alias (PR #440)
- #294 — master trigger pause/resume toggle (PR #441)
- #380 — auto-approve scope review (PR #442)
- #438 — claude_stream_idle_timeout_ms + Type-A/B classification (PR #443)
- #410 — subscription usage observability + /usage debug (PR #444)
- #271 — trigger visibility Tier 2 + Tier 3 (PR #445)
- #333 — Claude post-result idle timeout + ✓ turn complete UX hint (PR #446)
- #269 — hot-reload [progress] settings (PR #447)

Bumps to TestPyPI for staging via @hetz_lba1_bot once integration tests
U1-U7 pass against @untether_dev_bot.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Two small docs-only updates:

- .claude/rules/release-discipline.md — add "Pre-1.0 minor judgement"
  paragraph clarifying that opt-in additive features behind config flags
  may ship in patches if they preserve all current defaults. Codifies
  precedent set by [security] env_extra_allow (#409 in v0.35.3).
  Removes ambiguity for upcoming v0.35.8 (Pi RPC, #170) decision.

- README.md — fix engine compatibility matrix: Pi "Model in footer" cell
  changes from "—" to "✅⁷" with footnote explaining Pi populates the
  footer model from a supplementary StartedEvent carrying the model name
  extracted from message_end (#225). Code at src/untether/runners/pi.py:290-307
  has implemented this since #225 landed; matrix was stale.

Related: docs/plans/2026-05-02-pi-engine-enhancements.md (local plan,
gitignored) — covers the broader Pi enhancement roadmap that motivated
both fixes. Issues created: #460-#468 + promotions of #170 → v0.35.8 and
#180 → v0.35.9.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 3, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ad69bb2d-6469-4511-9081-202522ec07bf

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/pi-roadmap-and-doc-fixes

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

- docs/reference/dev-instance.md: add Engine auth & defaults section
  (matrix of CLI ver, auth method, default provider/model, cred location
  for Claude/Codex/Gemini/OpenCode/Pi/AMP), smoke verification commands,
  per-engine notes (OpenCode google-whitelist=[], Pi Kimi K2.6 zero-cost,
  Gemini trusted folders + #471, AMP mode-not-model routing). Also
  document the three special-purpose instances (demo, dev-hf, dev-ws)
  and the lockfile PID-reuse race
- docs/reference/integration-testing.md: cross-reference the new auth
  section so test runs check current state before tier 1
- CLAUDE.md, .claude/rules/dev-workflow.md: extend 2-instance section to
  the full 5-instance topology, clarifying that demo/dev-hf/dev-ws share
  the editable .venv but are not on the release path
- .claude/hooks.json: dev-workflow-guard now recognises all 4
  editable-source services (untether-dev, untether-dev-hf,
  untether-dev-ws, untether-demo) and only blocks restarts of staging

Co-Authored-By: Claude Opus 4.7 (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