Skip to content

Revise dossier base schema structure#33

Open
dhh1128 wants to merge 1 commit into
mainfrom
update-dossier-base
Open

Revise dossier base schema structure#33
dhh1128 wants to merge 1 commit into
mainfrom
update-dossier-base

Conversation

@dhh1128
Copy link
Copy Markdown
Member

@dhh1128 dhh1128 commented Jun 2, 2026

Summary

Proposes an update to the Dossier (Base) schema (dossier-base/dossier-base.json), replacing the placeholder base with a refined field set and clearer field semantics.

Envelope

  • Add issuer (i) and schema (s) fields and a top-level rules block (r) to the ACDC envelope; reorder envelope fields for the conventional v, d, i, s, ... ordering.
  • Reframe the IS-A-dossier definition recursively: a schema S is a dossier iff its top-level allOf contains a $ref to this SAID, or recursively to another dossier schema. Issuee discouraged; all evidence carried in e, never a.

a (metadata) block

  • Expand field descriptions (assembly vs. issuance vs. event timing, jurisdiction vs. location, governance framework vs. procedural rules).
  • Rename assemble_dtassembly_dt and classcls.
  • Allow object form for evt_loc; relax jur array minItems constraint.
  • Drop the redundant a.dt field — issuance date lives on the envelope.

e (edges) block

  • Restructure the description to document compact (SAID string) and expanded (object) forms; defer specific edge shapes to derived schemas.

SAID

  • $id recomputed to ECqmlipYuqp8LA_7WdZGt_cKP9eK3hXtHRZGNgJ7NKEx. Verified self-consistent against the schema content via keri.core.scheming.Schemer (the same computation as tools/cli/saidify_schema.py).

Note: dossier-base is not yet listed in registry.json, and the prior SAID was not referenced elsewhere in the repo, so this change is self-contained.

🤖 Generated with Claude Code

Update the Dossier (Base) schema with a refined field set and clearer
field semantics:

- Add issuer/schema fields (i, s) and a top-level rules block (r) to the
  required ACDC envelope; reorder envelope fields.
- Reframe the IS-A-dossier definition recursively via allOf $ref chains.
- Expand a-block metadata descriptions; rename assemble_dt -> assembly_dt
  and class -> cls; allow object form for evt_loc; relax jur array minItems.
- Drop the redundant a.dt field (issuance date lives on the envelope).
- Restructure the e (edges) block description for compact/expanded forms.
- Recompute $id SAID to ECqmlipYuqp8LA_7WdZGt_cKP9eK3hXtHRZGNgJ7NKEx.

Signed-off-by: Daniel Hardman <daniel.hardman@gmail.com>
Copilot AI review requested due to automatic review settings June 2, 2026 16:18
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the dossier-base JSON Schema to replace the prior placeholder dossier definition with a more explicit ACDC envelope layout and clearer semantics for the metadata (a) and edges (e) blocks.

Changes:

  • Revises the envelope to emphasize conventional field ordering and to include issuer (i), schema (s), and an optional rules block (r).
  • Refines the a (metadata) block semantics and field names (e.g., assemble_dtassembly_dt, classcls) and relaxes some constraints.
  • Clarifies e (edges) block semantics as supporting compact (SAID) and expanded (object) forms while deferring edge shapes to derived schemas.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +41 to 43
"r": {
"description": "Optional ACDC rules block. Compact form: SAID string. Expanded form: object."
},
"v": {
"type": "string",
"description": "ACDC version string."
"description": "CESR version string."
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants