Folderbase Core v0.5.0

What's Changed

• docs: record Core v0.4.0 public proof by @jerelvelarde in #24
• feat(core): add metadata-only Folderbase capture planning by @jerelvelarde in #25
• feat(core): seal captures into transactional Local Head by @jerelvelarde in #26
• feat(core): seal productive tombstones safely by @jerelvelarde in #27
• feat(core): restore exact tombstone bytes without clobbering by @jerelvelarde in #28
• feat(core): ship the Folderbase 0.5 release candidate by @jerelvelarde in #32
• feat(core): unify migrations under durable transaction-v1 execution by @jerelvelarde in #33
• docs(release): record Core v0.5.0-rc.1 proof by @jerelvelarde in #38
• Add polished Folderbase README banner by @jerelvelarde in #39
• Anonymize the client fixture as Project 2 by @jerelvelarde in #40
• Add verified npx distribution for Folderbase Core by @jerelvelarde in #30
• Freeze Compatibility Contract v1 and publish stable CLI surface by @jerelvelarde in #42

Full Changelog: v0.4.0...v0.5.0

Folderbase Core v0.5.0-rc.1

Folderbase Core v0.5.0-rc.1 is the first installable release candidate for the ordinary-folder 0.5 architecture. Any ordinary folder can remain ordinary while .folderbase/ adds durable identity, local versions, opaque-file capture, optional narrative adapters, templates, sharing primitives, and crash-safe reorganization transactions.

This is intentionally a prerelease. Protocol 0.5 remains a sealed candidate (status: candidate); released protocol 0.4 remains immutable.

Release evidence:

• exact tag target: 45de7804bb4e57224e5b9495e4394441ce652f0b
• annotated tag object: 14528f26e0065c95cba0177aff40aa3660f613f6
• post-main CI: run 30646596964, green for Rust quality/package, macOS, and Windows
• protocol 0.4 release closure: 32 files verified
• protocol 0.5 candidate closure: 152 files plus external manifest sidecar verified
• extracted packages: Core 65 files, CLI 10 files; compile, tests, mutation proof, optimized install, and outside-checkout use passed
• strict formatting, clippy, rustdoc, workspace tests, public-surface, CI-policy, digest-vector, and package gates passed on the exact release tree

Install the exact reviewed commit for strict reproducibility:

cargo install \
  --git https://github.com/chalkagents/folderbase.git \
  --rev 45de7804bb4e57224e5b9495e4394441ce652f0b \
  --locked \
  folderbase-cli

folderbase --version
# folderbase 0.5.0-rc.1

The annotated public tag currently peels to the exact reviewed commit. Git tags can be moved or deleted by repository administrators unless protected separately, so the commit-pinned install is the stronger reproducibility pin.

The repository at the exact commit is the normative candidate protocol bundle. This release does not claim stable protocol 0.5, crates.io publication, managed Cloud availability, or production sync readiness.

Folderbase Core v0.4.0

Folderbase Core v0.4.0 publishes the first released folderbase-version-v1 contract: a bounded, portable, full-state Folderbase artifact with canonical digest rules, a closed JSON Schema, adversarial conformance corpus, independent reference encoder, and a Rust runtime implementation.

Release evidence:

• contract PR: #22
• release PR: #23
• release commit and tag target: 7160017612c9f557803c74031f1715c516935f6c
• annotated tag object: 920bea631b07d700f1050c2d3ad52ffbafaca59d
• post-main CI: run 30473316098 (Rust/package, macOS, Windows green)
• source distribution: exact 32 files (25 conformance + 7 contract)
• workspace tests: 497 passed, 3 ignored
• extracted Core and CLI packages plus clean install: green

Install from the immutable tag:

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

The repository/tag source archive is the normative cross-language protocol bundle. Cargo packages contain the runtime implementation and CLI; this release does not claim crates.io publication, filesystem capture/Local Head, sync, Cloud ingest, or hosted-byte availability.

Folderbase Core v0.3.0

Folderbase Core v0.3.0 publishes the local-first transfer, reorganization-planning, and exact-root attestation foundations for agent workspaces.

Added

• Canonical Chunk Manifest v1 validation and digest contracts.
• Bounded streaming sources for immutable Folderbase object transfers.
• Resumable canonical transfer receipt and verification into owned staging storage.
• Atomic, no-clobber installation of verified artifacts with integrity receipts.
• Deterministic, inert Reorganization Draft and Plan records.
• Exact logical-root and physical-instance attestation in Core and folderbase attest.
• Hosted contract coverage on Linux, macOS, and Windows.

File model

Core transfers every regular file type as an opaque byte stream plus chunk and integrity metadata. Large media and immutable database-file captures use the same bounded path. Application-consistent database snapshots require a format-aware adapter.

Deliberately deferred

This release does not apply or recover Reorganization Plans, install received artifacts into canonical Folderbase history, publish Remote Head, grant cloud authorization, perform hosted live sync, execute remote agents, or issue hosted sharing grants.

Install

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

Expected:

folderbase 0.3.0

Verification record: docs/verification/v0.3.0-transfer-reorganization-attestation.md.

Folderbase Core v0.2.1

Folderbase Core v0.2.1 is a crash-safety patch for additive folder migrations.

Fixed

• Publishes the initial migration journal atomically before the plan enters applying.
• Keeps an approved plan retryable when a process exits before journal publication.
• Makes every durable additive checkpoint reopenable and recoverable.
• Records staging-creation failures as a durable rollback.
• Preserves pre-existing or unowned staging bytes on journal and staging collisions.

Install

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

Expected version:

folderbase 0.2.1

Protocol and template versions are unchanged. Proposed streaming transfer, Folderbase Version/Remote Head, and mutation source-identity contracts are not included.

Full verification: docs/verification/v0.2.1-additive-migration-recovery.md.

Folderbase Core v0.2.0

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.

Folderbase Core v0.1.0

First public release of the Apache-2.0 Folderbase database core.

Highlights:

• Turn an ordinary folder into a structured Folderbase without moving existing files.
• Metadata-first inspection across repositories, documents, media, PDFs, databases, and large files.
• Agent-native JSON CLI for validation, navigation, optimistic text saves, migration, local versions, and recovery.
• Person, organization, customer, engagement, project, temporary, and custom templates.
• Explicit human and agent sharing policy, local-first availability rules, resumable transfers, and conflict-preserving sync primitives.
• Complete public protocol schemas, conformance fixtures, and an Okada-shaped synthetic transformation proof.

Install from the immutable release source:

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

Folderbase 0.x is pre-stable. Review protocol notes before upgrading between minor versions.