Skip to content

docs: record wave2 Nu 0.114 catalog completion - #85

Merged
tonythethompson merged 7 commits into
masterfrom
cursor/wave2-handoff-docs-54c8
Aug 5, 2026
Merged

tonythethompson merged 7 commits into
masterfrom
cursor/wave2-handoff-docs-54c8

Conversation

@tonythethompson

@tonythethompson tonythethompson commented Aug 5, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Bookkeeping for wave2 after numan-registry#45 production publish.

  • Update handoff success criteria (Linux prove done; Windows optional)
  • Add Wave 2 Nu 0.114 completion checklist to consolidated roadmap

Companion: numan-plugins backlog/manifest PROMOTED PR.

Review in cubic

cursoragent and others added 2 commits August 5, 2026 10:19
Mark handoff success criteria and consolidated roadmap for the five
wave2 plugins published via numan-registry#45.

Co-authored-by: Anthony Thompson <github@trackdub.com>
Co-authored-by: Anthony Thompson <github@trackdub.com>

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hey - I've left some high level feedback:

  • In the success criteria checklist, the final item 'Backlog + roadmap docs updated (numan-plugins bookkeeping PR; this file)' is still unchecked even though this PR appears to satisfy it; consider either checking it or clarifying that some follow-up work is still pending.
  • You mention Windows prove as 'optional follow-up' in the success criteria; if you plan to run it later, consider adding a brief note or sub-bullet indicating what would mark Windows prove as complete so future readers know when this criterion is fully satisfied.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- In the success criteria checklist, the final item 'Backlog + roadmap docs updated (numan-plugins bookkeeping PR; this file)' is still unchecked even though this PR appears to satisfy it; consider either checking it or clarifying that some follow-up work is still pending.
- You mention Windows prove as 'optional follow-up' in the success criteria; if you plan to run it later, consider adding a brief note or sub-bullet indicating what would mark Windows prove as complete so future readers know when this criterion is fully satisfied.

Fix all in Cursor


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@qodo-code-review

Copy link
Copy Markdown
Contributor

PR Summary by Qodo

Document Wave 2 Nu 0.114 catalog completion and handoff criteria

📝 Documentation 🕐 Less than 10 minutes

Grey Divider

AI Description

• Record Wave 2 Nu 0.114 promotion completion and production publish link in the roadmap.
• Update handoff success criteria to reflect Linux lifecycle-prove complete; Windows prove optional.
• Cross-link the relevant numan-plugins/numan-registry PRs for traceability.
Diagram

graph TD
  H["handoff-promote-0114-plugins.md"] --> R["consolidated-multi-repo-roadmap.md"] --> PR{{"GitHub PRs"}} --> RUN{{"Registry Actions run"}}
Loading
High-Level Assessment

The approach is appropriate for post-publish bookkeeping: it updates the two canonical planning documents and adds direct provenance links (PRs + production run) without introducing new process artifacts.

Files changed (2) +20 / -7

Documentation (2) +20 / -7
consolidated-multi-repo-roadmap.mdAdd Wave 2 Nu 0.114 promotion completion checklist and production run link +10/-0

Add Wave 2 Nu 0.114 promotion completion checklist and production run link

• Adds a dated Wave 2 Nu 0.114 CI-built promotion section enumerating the five published plugins and their provenance PR links. Records the production publish GitHub Actions run ID for auditability/traceability.

docs/plans/consolidated-multi-repo-roadmap.md

handoff-promote-0114-plugins.mdMark wave 1+2 success criteria complete; note Linux prove done and Windows optional +10/-7

Mark wave 1+2 success criteria complete; note Linux prove done and Windows optional

• Converts the success criteria checklist from pending to completed for wave 1+2 production, explicitly noting lifecycle-prove coverage on Linux/Nu 0.114.1 and that Windows prove remains optional. Leaves the backlog/roadmap bookkeeping item as the remaining open checkbox, pointing to the companion PR context.

docs/plans/handoff-promote-0114-plugins.md

@greptile-apps

greptile-apps Bot commented Aug 5, 2026 •

Copy link
Copy Markdown
Contributor

Greptile Summary

The PR records completion of the Wave 2 Nu 0.114 plugin-promotion handoff.

  • Marks build, registry publication, production deployment, lifecycle proof, discovery, and bookkeeping criteria complete.
  • Documents Linux and Windows x86_64 lifecycle validation.
  • Clarifies that changes to the contract-pinned consolidated roadmap require a coordinated contract bump.

Confidence Score: 4/5

The PR should not merge until the previously reported wave-count inconsistency is reconciled with the contract-pinned roadmap.

The current handoff still records five plugins in each wave and ten overall, while the consolidated roadmap enumerates only two Wave 1 packages, leaving the completion record internally inconsistent.

Files Needing Attention: docs/plans/handoff-promote-0114-plugins.md

Important Files Changed

Filename Overview
docs/plans/handoff-promote-0114-plugins.md Replaces the open handoff checklist with completed Wave 2 publication and lifecycle-validation records and clarifies roadmap bookkeeping.

Reviews (5): Last reviewed commit: "Merge branch 'master' into cursor/wave2-..." | Re-trigger Greptile

Comment thread docs/plans/handoff-promote-0114-plugins.md Outdated
@qodo-code-review

qodo-code-review Bot commented Aug 5, 2026 •

Copy link
Copy Markdown
Contributor

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📜 Skill insights (0)

Grey Divider


Remediation recommended

1. Unchecked docs criterion ✓ Resolved 🐞 Bug ≡ Correctness
Description
In handoff-promote-0114-plugins.md, the Success Criteria item “Backlog + roadmap docs updated”
remains unchecked even though this PR updates the consolidated roadmap with the Wave 2 Nu 0.114
completion entry. This makes the handoff checklist inaccurate about what work is still pending.
Code

docs/plans/handoff-promote-0114-plugins.md[183]

+- [ ] Backlog + roadmap docs updated (numan-plugins bookkeeping PR; this file)
Relevance

●●● Strong

Team routinely accepts doc/checklist accuracy fixes; no close rejected precedents found.

PR-#72
PR-#60
PR-#66

ⓘ Recommendations generated based on similar findings in past PRs

Evidence
The handoff doc still has the docs-update criterion unchecked, while the consolidated roadmap in
this PR adds the Wave 2 Nu 0.114 completion section—so the checklist no longer reflects the state
after this PR.

docs/plans/handoff-promote-0114-plugins.md[173-184]
docs/plans/consolidated-multi-repo-roadmap.md[132-141]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
The Success Criteria checklist still shows “Backlog + roadmap docs updated” as incomplete, but this PR updates the consolidated roadmap to record Wave 2 completion. This leaves the handoff doc’s status misleading.

### Issue Context
If there is still an external bookkeeping task (e.g., a separate `numan-plugins` PR), the checklist item should explicitly say what remains; otherwise it should be checked.

### Fix Focus Areas
- docs/plans/handoff-promote-0114-plugins.md[173-184]
- docs/plans/consolidated-multi-repo-roadmap.md[132-141]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Grey Divider

Context used
✅ Compliance rules (platform): 23 rules
✅ REVIEW.md

To customize comments, go to the Qodo configuration screen, or learn more in the docs.

Qodo Logo

Comment thread docs/plans/handoff-promote-0114-plugins.md Outdated
@qodo-code-review

Copy link
Copy Markdown
Contributor

Qodo Fixer

✅ Committed (1) · ☑ Fixed (1)

Grey Divider

Commits pushed directly to this PR — no separate fix PR opened.

Process — 1 fixed
  • ☑ Fixed: Unchecked docs criterion

@coderabbitai

coderabbitai Bot commented Aug 5, 2026 •

Copy link
Copy Markdown
Contributor

Review Change Stack

Important

Review skipped

No new commits to review since the last review.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: c4a03b80-3236-47d2-8e78-9c5e329844b7

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
📝 Walkthrough

Walkthrough

The handoff document now directs plugin roadmap bookkeeping to the backlog and records completed Wave 1 and Wave 2 promotion criteria for ten plugins, including registry, production, compatibility, lifecycle, and documentation evidence.

Changes

Nu 0.114 plugin promotion

Layer / File(s) Summary
Promotion completion records
docs/plans/handoff-promote-0114-plugins.md
Bookkeeping now targets the plugin roadmap and backlog instead of the contract-pinned consolidated roadmap. Success criteria record ten compatible plugins, merged registry PRs, production status, Linux and Windows lifecycle validation, compatibility searches, and supporting documentation updates.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

  • tonythethompson/numan#62: Updates related plugin roadmap and handoff documentation for Wave 1 and Wave 2 promotion progress.
🚥 Pre-merge checks | ✅ 8
✅ Passed checks (8 passed)
Check name Status Explanation
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.
Pipeline Stage Enum Ordering ✅ Passed The PR changes only one Markdown handoff document. The tracked tree contains no SessionWorkflowStage enum or named members, so no ordering, raw-literal, mapping, or inequality checks apply.
Gpu/Cpu Runtime Boundary ✅ Passed The PR modifies only documentation files for a Nushell package manager. No inference/, GPU/CPU requirements, main.py, or C# code exists in the repository. The GPU/CPU boundary check is inapplicable.
Managed Host Restart Safety ✅ Passed The PR-side diff changes only docs/plans/handoff-promote-0114-plugins.md; no managed-host or containerized readiness code is modified.
Title check ✅ Passed The title clearly identifies the main change: recording Wave 2 Nu 0.114 catalog completion.
Description check ✅ Passed The description directly explains the Wave 2 bookkeeping, lifecycle criteria, and production publication changes.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cursor/wave2-handoff-docs-54c8
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch cursor/wave2-handoff-docs-54c8

Warning

Review ran into problems

🔥 Problems

Linked repositories: Public OSS repositories can only analyze public repositories installed in this organization. Analyzed tonythethompson/QuickShell, tonythethompson/numan, tonythethompson/dependency-chain-substrate, skipped Trackdubllc/Trackdub.


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.

greptile-apps[bot]
greptile-apps Bot previously approved these changes Aug 5, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

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 `@docs/plans/consolidated-multi-repo-roadmap.md`:
- Around line 132-140: Regenerate the frozen roadmap contract using
scripts/bump-contract.sh after updating the Wave 2 Nu 0.114 CI-built promotion
section, and include the generated contract changes with this roadmap update. Do
not merge the roadmap addition while the contract remains unsynchronized;
otherwise revert the addition.

In `@docs/plans/handoff-promote-0114-plugins.md`:
- Line 183: Keep the “Backlog + roadmap docs updated” checklist item unchecked
until companion PR numan-plugins#42 merges and its backlog and manifest entries
change from ELIGIBLE to PROMOTED.
🪄 Autofix

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 Plus

Run ID: 7653a604-2793-42c4-aa2a-8384381f015c

📥 Commits

Reviewing files that changed from the base of the PR and between 00d0ecb and 2549b43.

📒 Files selected for processing (2)
  • docs/plans/consolidated-multi-repo-roadmap.md
  • docs/plans/handoff-promote-0114-plugins.md
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • tonythethompson/QuickShell (manual)
  • tonythethompson/numan (manual)
  • tonythethompson/dependency-chain-substrate (manual)
📜 Review details
⚠️ CI failures not shown inline (3)

GitHub Actions: CI / Roadmap drift: docs: record wave2 Nu 0.114 catalog completion

Conclusion: failure

View job details

##[group]Run ref_file=$(mktemp)
 �[36;1mref_file=$(mktemp)�[0m
 �[36;1mstatus=$(curl --silent --show-error --output "$ref_file" --write-out "%{http_code}" \�[0m
 �[36;1m  -H "Authorization: ***" \�[0m
 �[36;1m  -H "Accept: application/vnd.github+json" \�[0m
 �[36;1m  -H "User-Agent: numan-ci" \�[0m
 �[36;1m  "https://api.github.com/repos/tonythethompson/numan/git/refs/tags/${CONTRACT_TAG}")�[0m
 �[36;1mif [ "$status" = "404" ]; then�[0m
 �[36;1m  echo "::warning::Tag $CONTRACT_TAG does not exist yet; skipping SHA resolution check."�[0m
 �[36;1m  exit 0�[0m
 �[36;1mfi�[0m
 �[36;1mif [ "$status" != "200" ]; then�[0m
 �[36;1m  echo "::error::GitHub API returned HTTP $status for tag $CONTRACT_TAG."�[0m

GitHub Actions: CI / Roadmap drift: docs: record wave2 Nu 0.114 catalog completion

Conclusion: failure

View job details

##[group]Run curl --fail-with-body --silent --show-error --location \
 �[36;1mcurl --fail-with-body --silent --show-error --location \�[0m
 �[36;1m  https://raw.githubusercontent.com/tonythethompson/numan/$CONTRACT_SHA/docs/plans/consolidated-multi-repo-roadmap.md \�[0m
 �[36;1m  -o /tmp/consolidated-roadmap.md�[0m
 �[36;1mdiff -u docs/plans/consolidated-multi-repo-roadmap.md /tmp/consolidated-roadmap.md \�[0m
 �[36;1m  || (echo "::error::Local consolidated roadmap diverges from $CONTRACT_SHA."; \�[0m

GitHub Actions: CI / 4_Roadmap drift.txt: docs: record wave2 Nu 0.114 catalog completion

Conclusion: failure

View job details

##[group]Run ref_file=$(mktemp)
 �[36;1mref_file=$(mktemp)�[0m
 �[36;1mstatus=$(curl --silent --show-error --output "$ref_file" --write-out "%{http_code}" \�[0m
 �[36;1m  -H "Authorization: ***" \�[0m
 �[36;1m  -H "Accept: application/vnd.github+json" \�[0m
 �[36;1m  -H "User-Agent: numan-ci" \�[0m
 �[36;1m  "https://api.github.com/repos/tonythethompson/numan/git/refs/tags/${CONTRACT_TAG}")�[0m
 �[36;1mif [ "$status" = "404" ]; then�[0m
 �[36;1m  echo "::warning::Tag $CONTRACT_TAG does not exist yet; skipping SHA resolution check."�[0m
 �[36;1m  exit 0�[0m
 �[36;1mfi�[0m
 �[36;1mif [ "$status" != "200" ]; then�[0m
 �[36;1m  echo "::error::GitHub API returned HTTP $status for tag $CONTRACT_TAG."�[0m
🧰 Additional context used
📓 Path-based instructions (5)
**/*

📄 CodeRabbit inference engine (CLAUDE.md)

**/*: Use Serena's semantic, symbol-aware tools as the primary tools for reading and editing code; use built-in Read, Glob, Grep, and Edit only under the stated exceptions.
Before editing a code file, inspect its symbol overview, read the specific symbols being changed, and edit them with Serena's symbol-aware tools.
Understand the existing code before changing it and make the smallest change that satisfies the request; avoid unrelated cleanup, premature abstractions, unnecessary error handling, feature flags, and compatibility shims.
Prefer editing existing files over creating new ones, and never create Markdown or README files unless explicitly requested.
For exploratory questions, provide a 2–3 sentence recommendation with the main tradeoff and do not implement until the user agrees.
For UI or frontend changes that cannot be tested in a browser, explicitly state that browser testing was not performed rather than claiming success.
Address security issues when discovered, including injection, XSS, SQL injection, path traversal, and secret leaks.
Pause and obtain confirmation before destructive, hard-to-reverse, externally visible, or third-party-upload actions, including deleting files or branches, dropping tables, force-pushing, modifying CI/CD, posting externally, or uploading content.
When blocked, investigate the root cause instead of bypassing it with --no-verify, --force, or deletion; investigate unfamiliar files, branches, and configuration before deleting them.
Only commit when explicitly asked; do not proactively update git configuration or push changes.
Do not skip Git hooks unless explicitly asked; if a pre-commit hook fails, fix the issue, re-stage, and create a new commit rather than amending.
Stage files by name rather than using git add -A or git add ., to avoid accidentally including secrets or large binaries.
Use a HEREDOC for commit messages, and add co-author attribution only when the user explicitly requests the exact trailer.
Do not force-pus...

Files:

  • docs/plans/consolidated-multi-repo-roadmap.md
  • docs/plans/handoff-promote-0114-plugins.md
!**/.env,!**/credentials.json,!**/*.pem

📄 CodeRabbit inference engine (CLAUDE.md)

Do not commit files that appear to contain secrets, including .env, credentials.json, and PEM files; warn before doing so even if explicitly requested.

Files:

  • docs/plans/consolidated-multi-repo-roadmap.md
  • docs/plans/handoff-promote-0114-plugins.md
**/*.{rs,md}

📄 CodeRabbit inference engine (CONTRIBUTING.md)

Match existing naming, module layout, and documentation level in the file being edited; update AGENTS.md, docs/, or command help when structure, conventions, or user-visible behavior changes.

Tests must cover failure modes, not only successful execution.

Files:

  • docs/plans/consolidated-multi-repo-roadmap.md
  • docs/plans/handoff-promote-0114-plugins.md
**/*.{rs,md,toml}

📄 CodeRabbit inference engine (CONTRIBUTING.md)

Use the repository's established serialization and module conventions rather than introducing unrelated refactors.

Files:

  • docs/plans/consolidated-multi-repo-roadmap.md
  • docs/plans/handoff-promote-0114-plugins.md
**/*.md

📄 CodeRabbit inference engine (REVIEW.md)

Update documentation and AGENTS.md when project structure or conventions change.

Files:

  • docs/plans/consolidated-multi-repo-roadmap.md
  • docs/plans/handoff-promote-0114-plugins.md
🔍 Remote MCP GitHub Copilot

Relevant review context

  • PR #85 is documentation-only: two files changed (+20/-7). The related registry intake PR #45 is merged and records the same five plugins, Nu >=0.114.0 <0.115.0, verified with Nu 0.114.1, across four targets with Intel macOS excluded.
  • The required Roadmap drift check is failing. CI compares the local consolidated roadmap against the frozen contract SHA and explicitly requires a coordinated scripts/bump-contract.sh update when the roadmap changes.,
  • Other listed CI checks—including Linux, Windows, and macOS tests, formatting, Clippy, packaging, and acceptance checks—succeeded.
  • The companion numan-plugins#42 bookkeeping PR is still open; its stated purpose is to mark the five plugins PROMOTED, clear pending-registry metadata, and record Wave 2 completion. The current numan-plugins master still shows those entries as ELIGIBLE with pending-registry notes.,
  • The handoff checklist’s final item is now checked in the PR head, after an automated fix.,

Comment thread docs/plans/consolidated-multi-repo-roadmap.md Outdated
Comment thread docs/plans/handoff-promote-0114-plugins.md Outdated
consolidated-multi-repo-roadmap.md must match CONTRACT_SHA; keep
wave2 completion notes in the handoff and numan-plugins roadmap.

Co-authored-by: Anthony Thompson <github@trackdub.com>
Avoid directing agents to edit the consolidated multi-repo roadmap
without a coordinated CONTRACT_SHA bump.

Co-authored-by: Anthony Thompson <github@trackdub.com>
greptile-apps[bot]
greptile-apps Bot previously approved these changes Aug 5, 2026
Mark Windows lifecycle-prove done with completion rule and run link;
state backlog/roadmap criterion as satisfied via plugins#42 plus this handoff.

Co-authored-by: Anthony Thompson <github@trackdub.com>
@tonythethompson

Copy link
Copy Markdown
Collaborator Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 5, 2026 •

Copy link
Copy Markdown
Contributor
⚠️ Action not completed

Already reviewed.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@tonythethompson
tonythethompson merged commit ac4292c into master Aug 5, 2026
20 checks passed
@tonythethompson
tonythethompson deleted the cursor/wave2-handoff-docs-54c8 branch August 5, 2026 11:11
@linear-code

linear-code Bot commented Aug 5, 2026

Copy link
Copy Markdown

NUM-64

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.

2 participants