IF Commons GitHub

AnyFS

One typed interface to the places bytes live: a path is a normalized key, a place is a typed address, every read returns a revision and every write states what it expects, and the capabilities of a store are in its type, so that code which needs one cannot be handed a store without it. A store may also merge by nature: its changes are immutable version rows with time-ordered ids, replicas exchange deltas, and a replica takes changes from an allowlist of replicas, from anyone, or only from deltas signed by a key of the replica that made them (Ed25519, a roster of keys with the windows they speak in).

FactValue
Version0.1.0
Conformance levelL1
Distributedgithub, npm
LicensePolyForm-Noncommercial-1.0.0, source-available: free for noncommercial use, commercial use needs a license from the owner (see Licensing in Start here)
Import it as@intellectual-frontiers/anyfs

Areas

Layers

LayerFolderMay import of this library
governancesrc/governance/nothing
logicalsrc/logical/src/governance/, src/merge/
logicalsrc/merge/src/governance/
logicalsrc/docs/formats/src/docs/
logicalsrc/docs/src/governance/, src/logical/
physicalsrc/physical/memory-merge/src/governance/, src/logical/, src/merge/
physicalsrc/physical/memory/governance, logical
physicalsrc/physical/local/governance, logical
physicalsrc/physical/src/governance/, src/logical/, src/physical/memory/, src/physical/local/

Imports

Core, Crypto, Formats, System, Telemetry

Imported by

AnyFS Bridge, AnyFS command line, AnyFS Google Drive, AnyFS Git, AnyFS Git hosts, AnyFS OneDrive, AnyFS POSIX, AnyFS Query, AnyFS S3, AnyFS Serve, AnyFS SQL, AnyFS SSH, Estate, Planning

Specifications

Folders

FolderWhat it isMay import
spec-kit/The library's own specifications, numbered from 0001.nothing: Markdown and TSV
src/governance/Layer 1: paths, prefixes, revisions, expectations, capabilities, places and the problems a store reports.core, by package name
src/logical/Layer 2: the operations as data, the store type, the laws, attenuation, mounts, the layers and the conformance suite. Pure: no input or output.governance, by package name; core, by package name
src/merge/The pure algebra of a merge: UUID version 7 ids made by a hybrid clock with a random tail for each id (RFC 9562), version rows that are their own checksums, the state of a replica and the view of a path as the heads of its rows, deltas with trust, deferral and findings, the check of a replica's rows, and the layout laws of a SQL database that can be dumped and replayed.governance, by package name; core and the SHA-256 of crypto
src/physical/memory-merge/Layer 3: the store in memory that merges, the reference every backend that merges is held to.governance, logical and merge, by package name; core and the SHA-256 of crypto
src/docs/Typed documents over a store: codecs with canonical bytes, schemas with versions and migrations as code, layouts as code, and collections whose documents come with their revisions. Pure: it is a function of the operations of a store.governance and logical, by package name; core, by package name
src/docs/formats/The codecs of documents that need the file formats of commons: JSON5 and YAML trees.docs, by package name; core and the JSON5 and YAML formats of formats
src/physical/memory/Layer 3: the store in memory.governance and logical, by package name; core and the SHA-256 of crypto
src/physical/local/Layer 3: the store in a folder of the local file system.governance and logical, by package name; core, the SHA-256 of crypto, and files, paths, locks and errors of system
src/physical/Layer 3: the entry of the stores, and the tracer of the traced layer, made from the telemetry of commons.governance, logical, memory and local, by package name; core and telemetry
suite/The tests: every requirement, with the compile-time checks of the store type and the conformance of each backend.src/; the test module of commons, by package name
tools/The trace check and the packer bun run verify runs.the trace of mizan, system and the packer of commons, by package name

Quality

Quality: 81 tests: 81 passed, 0 failed, 0 skipped, 88 of 88 requirements proved, 0 open issues, 0 open tickets. The tests and issues of the library

Titles, headings, exports, tables, columns and requirements. Esc closes.