Next Core release

This page describes completed source work that is awaiting the next immutable GitHub, npm, crates.io, and Homebrew release. It is not part of the immutable Core 0.5 release. Check folderbase protocol contract --json before using any optional capability.

Experimental optional query/index capability

Builds that advertise folderbase.query-index@0.1.0 provide:

• bounded metadata-first live queries over every ordinary file type;
• exact historical Folderbase Version queries with live and deleted lifecycle;
• deterministic filters, ordering, pagination, and snapshot-bound cursors;
• query explanations naming source, exclusions, ordering, and content access;
• explicit status and rebuild commands for one disposable private index;
• closed JSON success, attention, and error documents;
• an implementation-neutral public conformance suite; and
• native CLI conformance on macOS and Windows in post-merge CI.

The capability remains additive: Compatibility Contract v1, Folderbase CLI JSON v1, and the immutable Core 0.5 release closure are unchanged.

Read Query a Folderbase and the query/index wire reference.

Stable optional template-expansion capability

Builds that advertise folderbase.template-expansion@0.1.0 provide:

• read-only planning for one exact data-only Template Protocol 0.2 package;
• reviewed application bound to the exact physical folder instance and current plan;
• no-clobber additions that preserve every existing user path;
• idempotent replay and immutable template-application history;
• explicit handoff to reorganization for lineage or structural changes;
• bounded stdin, typed parser and operational errors, and safe output transport;
• a nine-case implementation-neutral public conformance suite, including a simulated 10 GiB metadata-first collision; and
• policy-pinned native CLI conformance on macOS and Windows after merge.

The capability does not make templates permanent schemas and does not stabilize the built-in catalog, “latest” selection, or init --template convenience.

Read Start from a template and the template expansion wire reference.