IF Commons GitHub

AnyFS Query: layers

0001Active

0001-query-layers · owner if · domain commons

Requirements

FR-001checkpassing

The manifest MUST declare the library as a plugin of the family of anyfs that extends @intellectual-frontiers/anyfs, with the exports ., ./governance and ./logical that the package has, and two layers: governance, which imports only core and the governance of AnyFS, and logical, which imports governance, core, AnyFS and the SQL language library @intellectual-frontiers/lang-sql.

Enforced (check): .github: cd commons/anyfs-query && bun run verify — suite/layers.test.ts

Proved by: anyfs-query/suite/layers.test.ts

Written in: anyfs-query/about.ts, anyfs-query/library.ts, anyfs-query/src/governance/mod.ts, anyfs-query/src/logical/mod.ts, anyfs-query/src/mod.ts, anyfs-query/tools/check.ts and 1 more

Tests: passed: suite/layers.test.ts the manifest is a plugin of the family of AnyFS whose exports are the ones of the package,

FR-002checkpassing

No source of the library MUST reach a file, a network, a process or the clock, and none MUST ask a store for an operation that changes it (write, delete, batch, rename or append): the time is a value of the context a query is run with, and a store is reached only through list, stat, history and read.

Enforced (check): .github: cd commons/anyfs-query && bun run verify — suite/layers.test.ts

Proved by: anyfs-query/suite/layers.test.ts

Tests: passed: suite/layers.test.ts no source reaches a file, a network, a process or the clock, and none asks a store for an

Acceptance scenarios

  1. Given the manifest, When its exports are compared with the package's, Then they are the same, per FR-001.
  2. Given the sources of both layers, When they are read, Then none imports node: or the system or network libraries, none reads the clock and none names a changing operation, per FR-002.

Out of scope

  • The stores themselves and the means of naming a place: a context gives them (0004-query-safety).

Edge cases

  • The logical layer imports the language library by package name and no other library of the family but AnyFS (FR-001); the tests of the library import stores of other plugins, and no source does.

Assumptions

  • The context gives the clock, so a run needs no ambient time (FR-002).

Open questions

  • None.

Key entities

  • Plugin, Layer, Unit.

Success criteria

SC-001success criterion

Every behaviour is tested over stores in memory and, where a file system is touched, in a folder, with no network and no real time.

Review & acceptance checklist

  • [x] Every requirement is testable (MUST / MUST NOT), not aspirational
  • [x] No company fact is asserted here
  • [x] Every open item is marked, not silently decided

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