feat: list-meta / list-schema commands + meta index #90

New Issue

2026-06-01T04:55:53Z

xiaoju commented

2026-06-01 04:55:53 +00:00

Background

list --type does exact hash matching. When meta-schema evolves (new version = new hash), old schemas typed by the previous meta-schema become invisible.

Definitions

Meta-schema: any node where type === hash(self) (self-describing)
Schema: any node whose type ∈ meta-schema set

Changes

Core (json-cas-fs)

Add persistent meta index (_index/_meta file) — a list of all meta-schema hashes
Maintain metaSet: Set<Hash> in memory, updated on put() when typeHash === hash
Migration: on first load, scan typeIndex to build _meta from existing data
Add listMeta(): Hash[] and listSchemas(): Hash[] to Store interface

CLI (cli-json-cas)

json-cas list-meta — lists all meta-schemas
json-cas list-schema — lists all schemas (instances of any meta-schema)

Notes

listSchemas() = metaSet.flatMap(m => typeIndex[m])
No full store scan needed — index-driven O(1) for meta, O(meta-count) for schemas

小橘 🍊（NEKO Team）

## Background `list --type` does exact hash matching. When meta-schema evolves (new version = new hash), old schemas typed by the previous meta-schema become invisible. ## Definitions - **Meta-schema**: any node where `type === hash(self)` (self-describing) - **Schema**: any node whose `type ∈ meta-schema set` ## Changes ### Core (json-cas-fs) 1. Add persistent **meta index** (`_index/_meta` file) — a list of all meta-schema hashes 2. Maintain `metaSet: Set<Hash>` in memory, updated on `put()` when `typeHash === hash` 3. Migration: on first load, scan typeIndex to build `_meta` from existing data 4. Add `listMeta(): Hash[]` and `listSchemas(): Hash[]` to Store interface ### CLI (cli-json-cas) 5. `json-cas list-meta` — lists all meta-schemas 6. `json-cas list-schema` — lists all schemas (instances of any meta-schema) ## Notes - `listSchemas()` = `metaSet.flatMap(m => typeIndex[m])` - No full store scan needed — index-driven O(1) for meta, O(meta-count) for schemas 小橘 🍊（NEKO Team）

xiaoju referenced this issue from a commit

2026-06-01 05:24:49 +00:00

feat: add list-meta and list-schema commands with persistent meta index

xiaoju referenced a pull request that will close this issue

2026-06-01 05:26:07 +00:00

feat: add list-meta and list-schema commands with persistent meta index #91

xiaoju closed this issue

2026-06-01 05:48:07 +00:00

This repo is archived. You cannot comment on issues.