dev.jisaku.mosimo.validity

情報の有効期間Validity · 投稿の拡張

避難指示の適用期間や警報の対象期間のように、原情報が明記する期間を from・until の端点として保持する。有効期間の終了は投稿の削除・撤回を意味せず、省略された端点は不明を表す。

OVERVIEW / 要点02 EXTENSIONS
  1. 作成時刻 created_at、有効期間 from〜until、配送期限 exp は所有者も意味も異なる三つの時間である。
  2. 期間は from <= t < until。拡張を置くなら少なくとも一方の端点を持つ。
  3. 不明な端点を配送期限・受信時刻・現在時刻から補ってはならない。
  4. 原情報の発生時刻と有効開始時刻は別の概念であり、意味が一致する場合だけ対応付ける。
有効期間 独立に設定 作成時刻 created_atNostr イベント 有効開始 fromこの時刻を含む 有効終了 untilこの時刻を含まない 配送期限 exp投稿の基本項目
三つの時間。有効期間と配送期限は互いに独立しており、有効期間の終了は削除を意味しない

目的

本プロトコルは、投稿内容がいつの状況・指示として有効かを表す「情報の有効期間」を、投稿の拡張として定義する。避難指示の適用期間や警報の対象期間のように、原情報が明記する期間を構造化情報として保持し、対応クライアントが期間に基づく表示・整理を行えるようにすることが目的である。

本書が保証するのは、著者が記した期間の端点がそのまま保持・復元されることである。有効期間は配送期限とは別の概念であり、有効期間の終了は投稿の削除・撤回を意味しない。省略された端点は不明であり、無期限に有効であることも意味しない。

前提

識別子 文書 依存する理由
dev.jisaku.mosimo コア 共通時刻型 Timestamp、配送期限 exp との区別、拡張の共通構造と運び方

1. 型

type ValidityExtension = {
  $type: "dev.jisaku.mosimo.validity";
  from?: Timestamp;
  until?: Timestamp;
};
項目 必須 意味
from 任意 内容が有効になる時刻
until 任意 内容が有効でなくなる時刻

時刻の表記と精度はコア §3.1に従う。正規の定義は lexicon.json である。

2. 三つの時間の区別

時間 所有者 意味
作成時刻 created_at Nostr イベントの標準フィールド 投稿を作成した時刻
情報の有効期間 from〜until 本拡張 内容がその時点の状況・指示として有効な期間
配送期限 exp 投稿の基本項目 新たなメッシュ配送の対象とする期限

有効期間と配送期限は独立に設定する。配送期限が有効期間より先に満了することも、有効期間の終了後も配送期限内であることもある。有効期間の終了を根拠に投稿を削除・撤回したものとして扱ってはならない。削除は著者の制御処理(削除要求)だけが表すためである。

3. 省略と不明

有効期間の拡張自体は任意である。拡張を置く場合は from・until の少なくとも一方を持たなければならない。両端のない拡張は情報を持たず、省略と区別できないためである。期間は from <= t < until とし、from は含み until は含まない。拡張がない投稿、または端点が省略された投稿の該当する端点は不明である。不明な端点を、配送期限、受信時刻、作成時刻、現在時刻のいずれからも補ってはならない。補った値は著者が主張していない期間を署名付きの情報として表示することになるためである。

4. 原情報の時刻との対応

原情報が持つ現象発生時刻と有効開始時刻は異なる概念である。取り込み側は、CAP の onset や BSAF の time: のような原情報の時刻項目を、その意味が有効期間の開始・終了に一致する場合に限り from・until へ対応付ける。意味を確認せずに置き換えてはならない。発生時刻を開始時刻として配送すると、まだ有効でない指示を有効として表示するためである。原表記が必要な場合は公的情報の出典に保持する。

5. Nostr 上の表現

コア §7.3の自己完結した拡張タグで運ぶ。

["mosimo:ext:dev.jisaku.mosimo.validity", B64(C({from?, until?}))]

C は atproto deterministic CBOR、B64 は padding なしの通常 Base64 である。内部の時刻は原表記の文字列のまま保持する。

参照

Lexicon

正規の型定義

dev.jisaku.mosimo.validity#main/protocol/validity/lexicon.json ↗
protocol/mosimo/validity/lexicon.json を表示
{
  "lexicon": 1,
  "id": "dev.jisaku.mosimo.validity",
  "defs": {
    "main": {
      "type": "object",
      "description": "The period during which the post content is valid as a description of the situation or as an instruction. Distinct from the mesh delivery deadline. An omitted endpoint is unknown; do not infer it from delivery deadlines or receipt times.",
      "properties": {
        "from": {
          "type": "string",
          "format": "datetime",
          "description": "Start of validity. UTC with an uppercase Z suffix; preserve the original string. Omit when unknown."
        },
        "until": {
          "type": "string",
          "format": "datetime",
          "description": "End of validity. UTC with an uppercase Z suffix; preserve the original string. Omit when unknown. Expiry does not delete or retract the post."
        }
      }
    }
  }
}