docs: clarify Claro v1 status and validation

This commit is contained in:
Hermes Agent
2026-06-07 03:03:13 -06:00
parent 0da1095c03
commit 1e0ea06d21
74 changed files with 2351 additions and 336 deletions
+50
View File
@@ -0,0 +1,50 @@
# Claro Package Registry Plan
Current release: **Claro v1.18.26**
Claro already has a local project/package foundation. A remote package registry should come later, after safety and teaching rules are clear.
## Ready now
- `claro new`
- `claro package init`
- `claro package add`
- `claro package list`
- `claro package remove`
- `claro package doctor`
- `claro package lock`
- package-name safety checks
## Registry goals
A beginner-friendly registry should be:
- predictable
- safe by default
- easy to inspect
- offline-tolerant where possible
- resistant to path traversal and confusing package names
## Needed before downloads
- package manifest format
- semantic version or simple v1-compatible version rules
- dependency constraints
- lock-file checksums
- package archive format
- signature or checksum verification
- local cache rules
- clear error messages when the network is unavailable
## Suggested phases
1. Local install from a folder.
2. Package export to a `.claro-package` archive.
3. Lock-file checksum verification.
4. Read-only registry index download.
5. Safe install from registry.
6. Publishing flow only after moderation/auth rules are designed.
See also:
- `V1_16_PACKAGES_PROJECTS.md`
- `CURRENT_STATUS.md`
- `ROADMAP.md`