From 8e4913230df0a7886d5eba0ec43f1aa4cfcd77b2 Mon Sep 17 00:00:00 2001 From: Viacheslav Ptsarev Date: Tue, 20 Oct 2026 16:38:39 +0200 Subject: [PATCH] feat(standards): register selected annotation transfer vocabulary --- CHANGELOG.md | 9 +++++++++ src/standards/flags-what.ts | 14 ++++++++++++++ src/standards/vocabulary.ts | 4 ++++ 3 files changed, 27 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index ed8bf02..b7d9675 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,15 @@ Versions before 0.8.0 are in the [git tags](https://github.com/WireCatLabs/cli-b Every entry says what changed as a caller sees it, why, and what to watch for — the rules are [`docs/dev/CONVENTIONS.md`](docs/dev/CONVENTIONS.md#the-changelog). +## Unreleased + +### Added + +- **Selected annotation workflows share the `annotations` resource and explicit `--target-store` and + `--bindings` flags.** A CLI can export, check and restore derived records without implying a full + archive backup or choosing destination identities by name. Each command states its included and + omitted facets; `check` keeps its existing read-only meaning. + ## 0.47.3 — 20.10.2026 ### Fixed diff --git a/src/standards/flags-what.ts b/src/standards/flags-what.ts index 66118e1..11c5072 100644 --- a/src/standards/flags-what.ts +++ b/src/standards/flags-what.ts @@ -1,6 +1,20 @@ import type { VocabularyFlag } from "./vocabulary.js" export const WHAT_FLAGS: VocabularyFlag[] = [ + { + name: "--target-store", + value: "", + role: "target", + type: "path", + meaning: "explicit destination store file for checking or restoring selected annotations", + }, + { + name: "--bindings", + value: "", + role: "target", + type: "path", + meaning: "JSON file mapping source typed references to explicitly selected destination references", + }, { name: "--context-source", value: "", diff --git a/src/standards/vocabulary.ts b/src/standards/vocabulary.ts index 24105eb..1dfca38 100644 --- a/src/standards/vocabulary.ts +++ b/src/standards/vocabulary.ts @@ -227,6 +227,10 @@ const collections: [string, string][] = [ ["documents", "files imported from Google Drive or Docs, or linked in a chat"], ["notes", "text the owner writes, or files from a notes folder"], ["projects", "the owner's work units with a task key"], + [ + "annotations", + "derived records attached to a selected entity, with explicit coverage of included and omitted facets", + ], ["organizations", "companies, teams, families or communities"], [ "identities",