feat(absorb): helioscope into helios-cli (rationalization)

[KooshaPari]

User description

Summary

Assessment PR for helioscope → helios-cli per phenotype-registry/RATIONALIZATION_PLAN.md.

Verdict: blocked for code merge — unrelated git histories (no merge-base); full git subtree add --squash duplicates ~5,134 files. Canonical path is archive helioscope + redirect to helios-cli; cherry-pick only if unique commits are found.

Changes

• Adds docs/rationalization/helioscope-absorption.md with divergence stats, rejection rationale, and recommended archive-first path.

Test plan

• Document-only change
• Linux CI (rust-ci.yml) on merge (local Windows cargo check hit pre-existing codex-windows-sandbox parse error on main)

Do not merge

Rationalization policy: PR-only, no merge until green + review.

---

Note

Low Risk
Documentation-only; no runtime, auth, or build logic changes.

Overview
Adds docs/rationalization/helioscope-absorption.md to record the helioscope → helios-cli rationalization decision under phenotype-registry/RATIONALIZATION_PLAN.md.

The doc blocks a full code merge: no git merge-base, and a squash subtree would duplicate ~5k files (~790k LOC) instead of consolidating. helios-cli stays canonical; helioscope is the retire candidate.

It recommends archive + README redirect, optional cherry-pick audit of ~283 helioscope-only commits, and notes Linux CI (rust-ci.yml) as the merge gate (local Windows cargo check failure called out as pre-existing).

^{Reviewed by Cursor Bugbot for commit 74ffe91. Bugbot is set up for automated code reviews on this repo. Configure here.}

---

CodeAnt-AI Description

Document the decision to block a full helioscope merge into helios-cli

What Changed

• Adds an assessment document that says the full repo merge should not proceed because the two codebases have unrelated histories.
• Explains that a full subtree merge would duplicate the entire codex workspace instead of consolidating it.
• Recommends the safer path: archive helioscope, add a README redirect to helios-cli, and cherry-pick only any unique fixes if needed.
• Notes helios-cli as the canonical branch and points to Linux CI as the merge gate.

Impact

✅ Clearer repository migration path
✅ Fewer accidental duplicate code imports
✅ Safer helioscope retirement process

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

[gemini-code-assist]

Warning

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

[codeant-ai]

CodeAnt AI is reviewing your PR.

---

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

[codeant-ai]

CodeAnt AI finished reviewing your PR.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

This is a documentation-only PR that adds an assessment document for the helioscope → helios-cli repository rationalization. The markdown file is well-structured and contains no code logic, security concerns, or implementation issues.

The PR correctly:

• Documents the blocked merge decision due to unrelated git histories
• Notes the duplicate payload concern (~5k files, ~790k LOC)
• Recommends the correct archive-first path
• Identifies the canonical fork (helios-cli) and retire candidate (helioscope)
• References the relevant plan document and policy

No inline comments required as this is pure documentation with no code changes.

Files Reviewed (1 file)

• docs/rationalization/helioscope-absorption.md — 0 issues (documentation)

---

_{Reviewed by laguna-m.1-20260312:free · 237,593 tokens}