Skip to content

Folderbase Core v0.2.0

Choose a tag to compare

@jerelvelarde jerelvelarde released this 28 Jul 19:58
f5ae84c

Folderbase Core v0.2.0 adds a safe, Core-owned approval contract for turning a live folder into a Folderbase.

Highlights:

  • Preview initialization once and receive an opaque SHA-256 plan digest owned by Core.
  • Apply only the exact approved request and physical filesystem root; same-path root replacement is stale.
  • Preserve ordinary user files without hashing their contents, including sparse multi-gigabyte media.
  • Detect topology, nested Folderbase boundaries, reconstructable trees, and Git metadata with bounded metadata-only traversal.
  • Reject symlink escapes and stale destinations before protocol writes; publish new files with no-clobber semantics.
  • Return typed invalid-plan, stale-plan, and inventory-limit errors plus the applied digest on success.
  • Keep protocol traversal policy consistent across initialization, inspection, migration, and workspace navigation.

Verification:

  • 336 tests passed; one subprocess helper is intentionally ignored by the aggregate runner.
  • Independent Standards and Spec/security reviews passed on the exact release head.
  • Merge-commit CI passed formatting, strict lint, tests, policy checks, package extraction, and installed CLI verification.

Install from the immutable release source:

cargo install --git https://github.com/chalkagents/folderbase.git --tag v0.2.0 --locked folderbase-cli

Folderbase 0.x is pre-stable. v0.2.0 intentionally changes the initialization approval API and wire shape from v0.1.0; clients should treat Core plan digests as opaque.