octeract-context 0.0.0-stage → 4.0.0

package/AGENTS.md

@@ -0,0 +1,32 @@
+# OCTERACT 8D CONTEXT & AUTONOMOUS SHIELD PROTOCOL
+
+CRITICAL INSTRUCTIONS FOR ALL AI AGENTS (Antigravity, Cursor, Windsurf, Claude Code, Cline, Roo, Copilot):
+This repository is monitored, indexed, and actively protected by the **Octeract-Context 8D Hypercube Engine (E8 Riemannian Torus T^8)**.
+
+## 0. MANDATORY ONBOARDING DIRECTIVE (ZERO-TOUCH PROTOCOL)
+When you install Octeract, initialize, or are asked to set up the MCP:
+- **DO NOT merely say "MCP installed" and stop.**
+- You **MUST** immediately inspect the pre-existing health status from `.octeract/HEALTH_REPORT.md` or `.tesseract/HEALTH_REPORT.md` (or call `octeract_audit_health` / `octeract_hybrid_audit` / `octeract_stats`).
+- You **MUST** deliver a detailed, comprehensive report directly to the user in your response:
+  1. **Executive Summary:** Total files indexed in the 8D Octeract ($E_8$ Torus $T^8$) and overall health score.
+  2. **Every Critical Fracture Detected:** Broken imports, contract mismatches, altered methods, dead-ends, topological sinks, unmatched events, unreachable zombie islands, floating promises, dead exports, boundary violations, secret leaks, asymptotic degradations, and spurious causal fixes.
+  3. **Connected Network (Ripple Effect):** List all modules and subsystems connected to each broken file that are failing or will fail in cascade.
+  4. **Unified In-Depth Universal Diagnostic:** Deliver a single, deeply detailed, comprehensive analysis with 4 universal pillars:
+     - 🔍 **Radiografía del Problema:** Precise facts, exact variables/methods, why it fails silently or produces an issue.
+     - 💥 **El Peligro Oculto y Efecto Dominó:** All connected modules and downstream systemic consequences.
+     - 📜 **Evidencia en Código:** File, exact line number, and verbatim snippet.
+     - 🛡️ **Solución Quirúrgica Recomendada:** Exact fix verified via `octeract_safe_write`.
+  5. **Safe Healing Proposal:** Recommend exact surgical fixes using `octeract_safe_write` to prevent cascading regressions.
+
+## 1. SURGICAL CONTEXT (TOKEN CONSERVATION)
+- NEVER perform blind grep scans or dump thousands of raw code lines into the context window.
+- ALWAYS invoke `octeract_slice` with the target cell (CoreLogic, Storage, UI, Security, Config, Telemetry, Tests) or `octeract_trace_flow` to work in < 500 tokens.
+- For 8D spatial localization, invoke `octeract_slice` or `octeract_octeract_slice` to query geodesic neighborhoods in $T^8$ via the 256-ary fractal tree.
+- BEFORE modifying central interfaces, invoke `octeract_blast_radius` to preview multi-hop ripple effects (< 300 tokens).
+
+## 2. ACTIVE WRITE SHIELD & 8-AXIS EXOSKELETON (MANDATORY SAFE WRITES)
+- NEVER modify or overwrite existing files directly with blind write tools.
+- ALWAYS execute file changes through the MCP tool: `octeract_safe_write`.
+  * The 8-Axis Exoskeleton ($X$ AST Syntax, $Y$ Contract Topology, $Z$ Ephemeral Sandbox, $W$ Shannon Security, $\Phi$ Big-O Asymptotics, $\Psi$ Pearl Causal SCM, $\Omega$ Event Loop Dynamics, $\Xi$ Packaging & Runtime) verifies that both the Euclidean distance $D_{\text{shear}} \le 0.75$ and 8D Riemannian Torus distance $D_{\text{shear8D}}$ remain strictly within stability bounds.
+  * If `octeract_safe_write` returns `WRITTEN_SAFELY`, the change is safe and written to disk.
+  * If `octeract_safe_write` returns `BLOCKED_BY_SHIELD` or `BLOCKED_BY_4D_SHIELD`, the write is physically rejected to prevent catastrophic cascading collapse or data loss. Use the returned `synthesizedPatch` or safe alternative for immediate zero-touch remediation.

package/LICENSE.md

@@ -0,0 +1,28 @@
+Business Source License 1.1 (BSL 1.1)
+
+Parameters:
+- Licensor: Miguel Guerra <miguelguerra200022@gmail.com>
+- Licensed Work: TESSERACT-CONTEXT (4D Hypercube Context Engine & Autonomous Shield)
+- Initial Effective Date: October 19, 2026
+- Change Date: October 19, 2029
+- Change License: Apache License, Version 2.0
+- Additional Use Grant: You may make use of the Licensed Work for non-production purposes, including personal development, testing, research, academic study, and evaluating the software. Any use in a commercial production environment, incorporation into proprietary commercial SaaS offerings, or deployment within revenue-generating products requires an explicit commercial license agreement with the Licensor.
+
+---
+
+TERMS AND CONDITIONS
+
+1. Grant of License.
+Licensor hereby grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Licensed Work, subject to the terms and conditions of this License and the Additional Use Grant above.
+
+2. Commercial and Production Use.
+Any use of the Licensed Work, or any derivative work thereof, in production, within a commercial entity, or for commercial profit (including but not limited to hosting as a cloud service, integrating into commercial developer toolchains, or running automated autonomous agents in revenue-generating enterprise systems) requires a separate commercial license agreement. To obtain a commercial license, contact Miguel Guerra at miguelguerra200022@gmail.com.
+
+3. Attribution and Notice.
+You must retain all copyright notices, trademarks, and disclaimers in all copies or substantial portions of the Licensed Work.
+
+4. Change to Open Source License.
+On the Change Date specified above, this License shall automatically terminate and your rights to use the Licensed Work will be governed by the Change License (Apache License, Version 2.0) without further action required.
+
+5. Disclaimer of Warranties.
+THE LICENSED WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE LICENSED WORK.