docs: add community health files and update info for v0.2.0

varshith-Git · varshith-Git · commit db9475231482 · 2026-01-03T16:35:09.000+05:30
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,31 @@
+---
+name: Bug Report
+about: Report determinism, ingestion, or kernel correctness issues
+title: "[BUG]"
+labels: bug
+---
+
+### Description
+
+Describe the issue and expected behavior.
+
+### Category
+- Determinism divergence
+- Snapshot / WAL behavior
+- Quantization or clamping
+- Cross-architecture mismatch
+
+### Reproduction Steps
+
+### Hardware / Substrate
+
+CPU:
+Architecture:
+OS:
+
+### Input Data Characteristics
+
+Vector dimension:
+Value range:
+
+### Additional Notes
diff --git a/.github/ISSUE_TEMPLATE/feature_proposal.md b/.github/ISSUE_TEMPLATE/feature_proposal.md
@@ -0,0 +1,16 @@
+---
+name: Feature Proposal
+about: Suggest kernel-level improvements
+title: "[PROPOSAL]"
+labels: enhancement
+---
+
+### Problem Context
+
+### Proposed Change
+
+### Determinism Impact
+
+### Cross-substrate Considerations
+
+### Why this belongs in kernel (not evaluator)
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -0,0 +1,27 @@
+## Summary
+
+What does this change do?
+
+## Determinism Impact
+
+- [ ] No determinism impact
+- [ ] Improves determinism
+- [ ] Changes arithmetic behavior
+
+Explain why.
+
+## Cross-Architecture Behavior
+
+Tested on:
+- [ ] x86
+- [ ] ARM / Apple Silicon
+- [ ] Embedded / Jetson
+
+## Tests
+
+Include reproduction / validation cases.
+
+## Notes
+
+If this relates to forensic or evaluator tracks,
+confirm that logic is kernel-appropriate.
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -0,0 +1,43 @@
+# Valori Project Code of Conduct
+
+The Valori Kernel is a research–grade deterministic computation project. 
+Our work touches systems reliability, reproducibility, and substrate–level
+computing research. We welcome discussion, critique, and contributions — but
+expect interaction to remain respectful and technically grounded.
+
+## Expected Behavior
+
+Participants are expected to:
+
+- Engage constructively and in good faith
+- Critique ideas, not individuals
+- Focus on technical accuracy and clarity
+- Respect research rigor and empirical evidence
+
+## Unacceptable Behavior
+
+Examples include:
+
+- Personal attacks or harassment
+- Misrepresentation of technical claims
+- Intellectual dishonesty
+- Attempts to appropriate or reframe authorship of work
+
+## Research Integrity
+
+Valori maintains strict boundaries between:
+
+- Open–source kernel research and
+- Commercial / enterprise extensions
+
+Contributors must respect these licensing and scope boundaries.
+
+## Reporting Issues
+
+If you believe behavior or activity violates this policy, contact the
+maintainer privately through the repository issue tracker or project email.
+
+The maintainers reserve the right to remove contributions that threaten the
+integrity, safety, or research accuracy of the project.
+
+Thank you for helping maintain a collaborative research environment.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,48 @@
+# Contributing to the Valori Kernel
+
+Thanks for your interest in contributing.
+
+Valori is a deterministic computation kernel designed to eliminate
+substrate-driven divergence across architectures (x86 / ARM / GPU / embedded).
+The project prioritizes mathematical correctness, reproducibility, and
+cross-platform determinism over performance shortcuts.
+
+## Contribution Philosophy
+
+Contributions should:
+
+- Improve determinism, reproducibility, or verification
+- Strengthen fixed-point arithmetic correctness
+- Improve cross-substrate consistency guarantees
+- Add test coverage or validation proofs
+
+Contributions that optimize performance at the cost of determinism will
+not be accepted.
+
+## PR Requirements
+
+Pull requests must include:
+
+- Description of the change
+- Explanation of determinism impact
+- Reproducible test case
+- Cross-architecture notes (where applicable)
+
+## What is Out of Scope
+
+The following belong in private / enterprise tracks:
+
+- forensic analysis pipelines
+- incident replay engines
+- audit and compliance evaluators
+- production ingestion tooling
+
+These systems depend on the kernel but are not part of the open core.
+
+## Development Workflow
+
+1. Open an Issue describing the proposal
+2. Discuss approach and determinism implications
+3. Submit PR after agreement on direction
+
+Thank you for helping strengthen deterministic computing research.
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "valori-kernel"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2021"
 license = "AGPL-3.0-only"
 
diff --git a/README.md b/README.md
@@ -279,5 +279,30 @@ python test_valori_integrated.py
 
 ---
 
+
+## 🔬 Research & Citations
+
+Valori is based on peer-reviewed research into deterministic substrates.
+
+**Paper**: [Deterministic Memory: A Substrate for Verifiable AI Agents](https://arxiv.org/abs/2512.22280)
+
+```bibtex
+@article{valori2025deterministic,
+  title={Deterministic Memory: A Substrate for Verifiable AI Agents},
+  author={Valori Research Team},
+  journal={arXiv preprint arXiv:2512.22280},
+  year={2025}
+}
+```
+
+## 🏢 Enterprise Extensions
+
+While the **Valori Kernel** is open-source (AGPLv3), we provide commercial extensions for enterprise needs:
+
+- **Deterministic Evaluator**: A forensics harness for replaying and auditing production incidents bit-for-bit.
+- **Compliance Packs**: Pre-configured validators for SOC2 and financial audit trails.
+
+Contact `varshith.gudur17@gmail.com` for licensing.
+
 ## 📄 License
 AGPL-3.0 - See [LICENSE](LICENSE).
diff --git a/SECURITY.md b/SECURITY.md
@@ -0,0 +1,43 @@
+# Security Policy
+
+The Valori Kernel is used in analytical, forensic, and compliance-adjacent
+contexts. While the kernel itself does not process secrets or user data,
+we treat correctness and integrity as security-relevant properties.
+
+## Supported Versions
+
+Only the latest tagged release is supported for security and integrity fixes.
+
+## Reporting Vulnerabilities
+
+If you believe you have discovered:
+
+- a determinism-breaking behavior
+- cross-substrate divergence
+- arithmetic overflow edge case
+- snapshot / WAL integrity weakness
+
+please report privately rather than opening a public issue.
+
+Contact:
+varshith.gudur17@gmail.com
+
+Please include:
+
+- Reproduction steps
+- Hardware & architecture details
+- Input data characteristics
+
+Responsible disclosure is appreciated.
+
+## Determinism as a Security Boundary
+
+Because Valori is used in:
+
+- incident reconstruction
+- audit trails
+- replay verification pipelines
+
+nondeterministic behavior may affect investigative outcomes.
+
+We treat determinism failures with the same severity as security bugs.
