Skip to content
This repository was archived by the owner on Feb 25, 2026. It is now read-only.

Commit 6d5044e

Browse files
committed
doc(README): clarify some minor points
1 parent 46dddec commit 6d5044e

1 file changed

Lines changed: 4 additions & 10 deletions

File tree

README.md

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -204,10 +204,6 @@ Eka's global namespace combines human-readable labels with cryptographic verific
204204

205205
#### Repository Identity and Discovery
206206

207-
> **Note:** Repository identity through initialization commits with entropy injection is proposed for future implementation. Currently, repository identity is established through the root commit hash. The `ekala.toml` manifest is now implemented and serves as the single source of truth for a repository's atom composition.
208-
209-
Repository identity is established through an initialization commit with injected entropy, providing robust disambiguation of forks from mirrors. This temporal anchoring ensures that even identical repositories have different identities, preventing confusion between legitimate repositories and malicious forks.
210-
211207
The `ekala.toml` manifest serves as the single source of truth for a repository's atom composition:
212208

213209
```toml
@@ -239,13 +235,11 @@ While the underlying system uses cryptographic IDs for security, developers inte
239235
- `gl:group/project::library` - GitLab addressing
240236
- `company-atoms::auth-lib` - Custom alias for internal repositories
241237

242-
These URIs are resolved to cryptographic IDs in the lockfile, ensuring portability and security. The URI system supports:
238+
These URIs are resolved to full URLs in the manifest & cryptographic IDs in the lockfile, ensuring portability and security regardless of locally configured aliases. The URI system supports:
243239

244-
- **Multiple Platforms:** GitHub, GitLab, and custom repositories.
245240
- **Version Constraints:** Semantic versioning and exact version pinning.
246-
- **Aliases:** Custom names for frequently used repositories.
247-
248-
**Practical Implications:** The global namespace allows seamless collaboration across organizations while maintaining security. Teams can share atoms across different repositories, companies, or even continents, with mathematical guarantees that the right code is being used. The system scales naturally without requiring central coordination or registry maintenance, enabling a truly decentralized ecosystem.
241+
- **Aliases:** User configurable, custom names for frequently used repositories.
242+
- **Heuristics:** Intelligent heuristics help determine the most appropirate schema (e.g. `git@` implies ssh://) to obviate the need to express it in 90% of cases.
249243

250244
### Why This Matters: Beyond Package Management
251245

@@ -258,7 +252,7 @@ The result is a system where:
258252
- **Reproducibility is automatic** through cryptographic locking and deterministic builds
259253
- **Collaboration is seamless** through global namespace management and intuitive URIs
260254

261-
This foundation enables not just better package management, but a complete rethinking of how we build, distribute, and trust software in an increasingly interconnected world. Eka provides the infrastructure for a software supply chain that is as reliable and secure as the underlying mathematics that power it.
255+
This foundation enables not just better package management, but a complete rethinking of how we build, distribute, and trust software in an increasingly interconnected world. Eka provides the foundation for a software supply chain that is as reliable and secure as the underlying mathematics that power it.
262256

263257
## Development
264258

0 commit comments

Comments
 (0)