Add experimental ASTRA causal genome v0.1

[safal207]

What changed

• added cml.experimental.astra with deterministic ASTRA causal-genome primitives;
• added context-sensitive activation gates;
• added immutable mutation genealogy with explicit mutation kinds;
• added provenance-aware trust (verified still requires attached evidence);
• added topological-defect detection for missing evidence, unverified actions, intent/effect divergence, dangling causal links, dangling mutation parents, and genealogy cycles;
• added docs/research/ASTRA.md describing the non-normative research model and trust boundary;
• added six regression tests covering activation, mutation lineage, evidence binding, topological defects, divergence, and cycles.

Why

CML currently audits causal lineage around actions. ASTRA explores a complementary memory surface: how causal beliefs activate in context, evolve without overwriting history, preserve evidence/provenance distinctions, and expose structural breaks rather than silently repairing them.

The DNA/flower vocabulary is explicitly treated as an engineering analogy, not a biological claim.

Validation

A standalone checkout-shaped test harness for the new module/tests passed:

6 passed

The branch is based on exact main commit 27c56182f0cec74ae8cd4eb727a9466b53001f0f and is 3 commits ahead / 0 behind at PR creation time.

Full repository CI remains authoritative for integration-level validation.

[github-actions]

Relevant CML Memory

Deterministic retrieval for PR #298 at head 1d973f699632 against accepted memory on base 27c56182f0ce.

No publishable accepted memory matched this change

No publishable accepted memory met the relevance threshold.

---

Publishable candidates evaluated: 0 · selected: 0.
Public-repository policy surfaces only packs with visibility=public and contains_private_data=false.

CML memory is advisory: verify that the recorded constraints still apply. This comment grants no approval, execution, or merge authority.

[coderabbitai]

Important

Review skipped

Draft detected.

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 Plus

Run ID: a7797004-6e34-4efa-a28e-0e0921d140a0

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

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}