Skip to content

Add OpenSSL source development documentation #11

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 4 commits into
base: main
Choose a base branch
from
Draft

Add OpenSSL source development documentation #11

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1761108
Initial plan
Copilot Feb 8, 2026
51b74fe
Add OpenSSL development documentation and references
Copilot Feb 8, 2026
976fe85
Fix package.json syntax error (duplicate merged content)
Copilot Feb 8, 2026
a981054
Fix code example to use Node.js crypto directly
Copilot Feb 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -193,6 +193,7 @@ npm run format # Format with Prettier
- **[Core Directive](./CORE_DIRECTIVE.md)** - Foundational principles (required reading)
- **[Architecture](./notes/ARCHITECTURE_DRAFT.md)** - System design and components
- **[Research Foundations](./UNDER_PRESSURE_LOOMING.md)** - Theoretical background and tools
- **[OpenSSL Development Guide](./docs/OPENSSL_DEVELOPMENT.md)** - Working with OpenSSL source code
- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute
- **[License](./LICENSE)** - MIT License

Expand Down
54 changes: 48 additions & 6 deletions UNDER_PRESSURE_LOOMING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,49 @@ a node in a multi-agent network that shares a common kernel prompt

---

## 2. Self-Building & Self-Reconfiguring Systems
## 2. Cryptographic Foundations & Security Libraries

Strong cryptography is the bedrock of any security system. Understanding the
low-level implementations helps ensure correct usage and enables advanced
security work.

Key libraries and resources:

- **OpenSSL**
The de facto standard cryptographic library for SSL/TLS and general
cryptographic operations. Node.js's `crypto` module is backed by OpenSSL.

To study or work with OpenSSL source code:
```bash
git clone git://git.openssl.org/openssl.git
Copy link

Copilot AI Feb 8, 2026

Choose a reason for hiding this comment

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

This snippet uses the git:// OpenSSL clone URL, which is unauthenticated/unencrypted. Prefer https://github.com/openssl/openssl.git here as well (and optionally mention git:// only as a legacy alternative).

Suggested change
git clone git://git.openssl.org/openssl.git
git clone https://github.com/openssl/openssl.git

Copilot uses AI. Check for mistakes.
```

See [OpenSSL Development Guide](./docs/OPENSSL_DEVELOPMENT.md) for detailed
instructions on building, testing, and integrating OpenSSL.

- **libsodium**
Modern, easy-to-use cryptographic library with high-level APIs. Good for
developers who want strong defaults without deep cryptographic expertise.

- **BoringSSL / LibreSSL**
Forks of OpenSSL with different goals:
- BoringSSL: Google's fork focused on Chrome/Android needs
- LibreSSL: OpenBSD's fork focused on code quality and security

- **Cryptographic Standards**
- NIST FIPS 140-2/140-3 for validated cryptographic modules
- PKCS standards for public key cryptography
- RFC documents for cryptographic protocols (TLS, SSH, etc.)

**Design idea for this project:**
Use Node.js's `crypto` module (backed by OpenSSL) for all cryptographic
operations while maintaining awareness of the underlying implementations.
Document all cryptographic choices and align with industry standards and
the Core Directive's security-first approach.

---

## 3. Self-Building & Self-Reconfiguring Systems

We are interested in systems that can assemble, repair, and improve
themselves while staying aligned.
Expand Down Expand Up @@ -79,7 +121,7 @@ system from that blueprint.

---

## 3. Accessing & Simulating Restricted Content
## 4. Accessing & Simulating Restricted Content

Some development paths involve learning from or testing against systems
that are partially blocked, geofenced, or censored.
Expand Down Expand Up @@ -113,7 +155,7 @@ Directive.

---

## 4. Theoretical Foundations (Recursion, Autonomy, Resilience)
## 5. Theoretical Foundations (Recursion, Autonomy, Resilience)

The project sits on top of several deep ideas:

Expand Down Expand Up @@ -152,7 +194,7 @@ boundary.

---

## 5. Modular / Evolutionary Platforms and Projects
## 6. Modular / Evolutionary Platforms and Projects

We want a "hyper-modular" ecosystem where components can be swapped,
extended, or recombined.
Expand Down Expand Up @@ -190,7 +232,7 @@ decentralized substrates (P2P, blockchain, edge nodes).

---

## 6. Emerging & Speculative Research
## 7. Emerging & Speculative Research

Frontier work that strongly resonates with the project:

Expand Down Expand Up @@ -229,7 +271,7 @@ static bureaucracy.

---

## 7. How This Feeds Back Into the Repo
## 8. How This Feeds Back Into the Repo

Next steps that connect this research to concrete work:

Expand Down
Loading
Loading