Skip to content

ops: start v0.10.0 external adoption lane#765

Merged
EffortlessSteven merged 1 commit into
mainfrom
ops/v0.10.0-external-adoption-lane
May 17, 2026
Merged

ops: start v0.10.0 external adoption lane#765
EffortlessSteven merged 1 commit into
mainfrom
ops/v0.10.0-external-adoption-lane

Conversation

@EffortlessSteven

Copy link
Copy Markdown
Member

Summary

  • Open the v0.10.0 external adoption active goal.
  • Add the v0.10.0 external adoption plan area and implementation plan.
  • Register the plan in plans/README.md.

Files added/changed

  • .uselesskey/goals/active.toml
  • plans/v0.10.0-external-adoption/README.md
  • plans/v0.10.0-external-adoption/implementation-plan.md
  • plans/README.md

Validation

  • cargo xtask spec-check --strict
  • cargo xtask docs-sync --check
  • cargo xtask typos
  • git diff --check

Non-goals

  • No v0.10.0 release prep, version bump, tag, or publish.
  • No new contract packs, README badges, shipper work, provider compatibility claims, production security claims, broad refactors, or dependency churn.

What this enables next

  • A spec for clean-project external adoption smoke.
  • Local-path external adoption proof before any future release work.
  • Installed CLI and Rust dependency docs that are clearly separated from repo-local proof machinery.

@gemini-code-assist

Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@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, add credits to your account and enable them for code reviews in your settings.

@coderabbitai

coderabbitai Bot commented May 17, 2026

Copy link
Copy Markdown

Review Change Stack

Summary by CodeRabbit

  • Chores
    • Updated internal development planning and roadmap documentation to reflect the next phase of the project.

Walkthrough

The PR transitions the active goal lane from v0.9.1-release to v0.10.0-external-adoption, updating operational objectives and work items, then introduces comprehensive plan documentation defining the external adoption lane's scope, nine-step PR sequence, acceptance criteria, and rollback/stop conditions.

Changes

v0.10.0 External Adoption Lane

Layer / File(s) Summary
Lane metadata and objectives
\.uselesskey/goals/active.toml
Lane header metadata (id, title, owner, created date) is updated to v0.10.0-external-adoption and marked active. The objective is revised to focus on external/installed-user workflows (fixture adoption for scanner-safe/TLS/OIDC/webhook). The end-state checklist is replaced with external adoption smoke/audit and documentation separation criteria.
Lane work items and operational tasks
\.uselesskey/goals/active.toml
Nine planned work items define the lane's execution: lane-open, external-adoption-smoke-spec, external-adoption-smoke (with path and JSON validation), installed-cli-docs, clean-project-examples (webhook/OIDC/JWKS/TLS), cli-explain-inspect-polish, proof-handoff-boundary, adoption-regression-external-mode (default and --external modes), and lane-closeout—replacing prior v0.9.1 release-focused tasks.
Plan area documentation index
plans/README.md, plans/v0.10.0-external-adoption/README.md
The plans index is updated to include v0.10.0-external-adoption. A new plan area README explains the lane owns the v0.10.0 buildout for external adoption and installed-user workflows (making uselesskey useful from clean projects and installed CLI, not release preparation), and links to the implementation plan.
Detailed implementation plan and operational guidance
plans/v0.10.0-external-adoption/implementation-plan.md
A complete plan document defines the lane structure: plan metadata and milestone/spec/ADR linkage; objective (external adoption and installed-user workflows with fixture generation/verification); scope (9-step PR sequence) and non-goals (no release/publish); detailed 9-step PR tasks with per-step artifacts (spec doc, xtask wiring, examples, CLI polish, proof-boundary decision, regression flag, closeout docs); acceptance criteria for users (value without cloning, proof vs non-proof expectations) and maintainers (clean project modes, failure evidence); consolidated proof commands (docs-only, external-adoption-smoke in default/JSON/audit modes, and regression/PR validation with --external); rollback procedures (pre/post-land reversion and path narrowing without loosening bounds); and stop conditions (triggers for pausing/splitting: release prep, version bump/publish, security claims, secret payloads, provider/production assurance, and dependency/refactor churn).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes


🐰 A new plan hops into view,
External adoption's what we'll do!
Clean projects shine, no cloning fuss,
Fixtures safe—the journey's just,
A nine-step dance to prove it true! 🌟

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically describes the main change: opening the v0.10.0 external adoption lane.
Description check ✅ Passed The description directly relates to the changeset, providing a clear summary of objectives, files modified, validation steps, and scope boundaries.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch ops/v0.10.0-external-adoption-lane

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.uselesskey/goals/active.toml:
- Around line 38-49: The active goal entry for work_item id
"external-adoption-smoke-spec" currently points to spec "USELESSKEY-SPEC-0006"
but the implementation plan step 2 refers to adding and linking
"USELESSKEY-SPEC-0013-external-adoption-smoke.md"; update one of them so they
match: either change the work_item spec value to "USELESSKEY-SPEC-0013" in this
file, or modify the implementation plan step 2 to create/link
"USELESSKEY-SPEC-0006" so both references are identical.

In `@plans/v0.10.0-external-adoption/implementation-plan.md`:
- Around line 10-20: The linked_specs metadata array is missing
"USELESSKEY-SPEC-0013" while step 2 promises to add that spec link; update the
linked_specs array by adding the string "USELESSKEY-SPEC-0013" to the list
(matching the existing format), or alternatively update the step 2 description
to explicitly state that the metadata change will be performed in the subsequent
PR; locate the linked_specs array in the plan (the array shown with entries like
"USELESSKEY-SPEC-0002") and either append "USELESSKEY-SPEC-0013" or clarify step
2 so the plan and metadata remain consistent.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: a1fd35a6-9fee-45f8-9b07-efbd76cb1eba

📥 Commits

Reviewing files that changed from the base of the PR and between 43a6f46 and e441066.

📒 Files selected for processing (4)
  • .uselesskey/goals/active.toml
  • plans/README.md
  • plans/v0.10.0-external-adoption/README.md
  • plans/v0.10.0-external-adoption/implementation-plan.md

Comment on lines 38 to 49
[[work_item]]
id = "release-candidate-proof"
status = "done"
id = "external-adoption-smoke-spec"
status = "planned"
proposal = "USELESSKEY-PROP-0001"
spec = "USELESSKEY-SPEC-0006"
plan = "plans/v0.9.1-release/implementation-plan.md"
plan = "plans/v0.10.0-external-adoption/implementation-plan.md"
commands = [
"cargo xtask release-evidence --version 0.9.1 --patch --dry-run --summary",
"cargo xtask adoption-regression",
"cargo xtask adoption-regression --format json",
"cargo xtask claim-proof --all-stable",
"cargo xtask user-path-smoke",
"cargo xtask check-no-panic-family",
"cargo xtask claim-report --check-public-claims",
"cargo xtask contract-packs --check",
"cargo +nightly xtask pr-lite",
"cargo xtask pr",
"cargo xtask spec-check --strict",
"cargo xtask docs-sync --check",
"cargo xtask typos",
"git diff --check",
]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical | ⚡ Quick win

Spec reference mismatch with implementation plan.

Work item external-adoption-smoke-spec references USELESSKEY-SPEC-0006, but the implementation plan (step 2, lines 92-97) states that this work item will add USELESSKEY-SPEC-0013-external-adoption-smoke.md and update the active goal to link USELESSKEY-SPEC-0013.

Either:

  • This work item should reference USELESSKEY-SPEC-0013 instead of USELESSKEY-SPEC-0006, or
  • The implementation plan step 2 should reference USELESSKEY-SPEC-0006 instead of creating USELESSKEY-SPEC-0013

Please align the spec numbering between these two files.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.uselesskey/goals/active.toml around lines 38 - 49, The active goal entry
for work_item id "external-adoption-smoke-spec" currently points to spec
"USELESSKEY-SPEC-0006" but the implementation plan step 2 refers to adding and
linking "USELESSKEY-SPEC-0013-external-adoption-smoke.md"; update one of them so
they match: either change the work_item spec value to "USELESSKEY-SPEC-0013" in
this file, or modify the implementation plan step 2 to create/link
"USELESSKEY-SPEC-0006" so both references are identical.

Comment on lines +10 to +20
linked_specs = [
"USELESSKEY-SPEC-0002",
"USELESSKEY-SPEC-0003",
"USELESSKEY-SPEC-0005",
"USELESSKEY-SPEC-0006",
"USELESSKEY-SPEC-0008",
"USELESSKEY-SPEC-0009",
"USELESSKEY-SPEC-0010",
"USELESSKEY-SPEC-0011",
"USELESSKEY-SPEC-0012",
]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Missing SPEC-0013 in linked specs metadata.

PR step 2 (lines 92-97) states that it will add USELESSKEY-SPEC-0013-external-adoption-smoke.md and update this plan to link it, but the linked_specs array in the metadata does not include "USELESSKEY-SPEC-0013".

This creates an inconsistency where the plan describes updating itself to link SPEC-0013, but the metadata doesn't reflect that link.

Consider either:

  • Adding "USELESSKEY-SPEC-0013" to the linked_specs array now (as a forward reference to work that will be done in step 2), or
  • Clarifying in step 2's description that the metadata update will happen as part of that PR

Note: This is related to the spec numbering issue in .uselesskey/goals/active.toml work item 2, which references SPEC-0006 instead of SPEC-0013.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plans/v0.10.0-external-adoption/implementation-plan.md` around lines 10 - 20,
The linked_specs metadata array is missing "USELESSKEY-SPEC-0013" while step 2
promises to add that spec link; update the linked_specs array by adding the
string "USELESSKEY-SPEC-0013" to the list (matching the existing format), or
alternatively update the step 2 description to explicitly state that the
metadata change will be performed in the subsequent PR; locate the linked_specs
array in the plan (the array shown with entries like "USELESSKEY-SPEC-0002") and
either append "USELESSKEY-SPEC-0013" or clarify step 2 so the plan and metadata
remain consistent.

@EffortlessSteven EffortlessSteven merged commit a286cf1 into main May 17, 2026
5 checks passed
@EffortlessSteven EffortlessSteven deleted the ops/v0.10.0-external-adoption-lane branch May 17, 2026 17:16
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