XDUMP-1.12.0

xdump-metadata

Title:	XDUMP as a Minimal Recovery Mechanism for Round-Trip Knowledge Engineering Under Governance Loss
Author:	Ralph B. Holland
Affiliation:	Arising Technology Systems Pty Ltd
Contact:	ralph.b.holland [at] gmail.com
version:	1.12.0
Publication Date:	2026-01-10T00:59Z
Binding: Non-canonical
Scope: Methodological / architectural
Provenance:	This is an authored paper maintained as a MediaWiki document; edit history reflects editorial changes, not collaborative authorship.
Status:	final

xdump-metadata (Normative)

The metadata table immediately preceding this section is CM-defined and constitutes the authoritative provenance record for this XDUMP artefact.

All fields in that table (including title, author, affiliation, contact, version, publication date, binding, scope, provenance, and status) MUST be treated as normative metadata.

The assisting system MUST NOT infer, normalise, reinterpret, duplicate, or rewrite these fields. If any field is missing, unclear, or later superseded, the change MUST be made explicitly by the human and recorded via version update, not inferred.

Curator Provenance and Licensing Notice

This document predates its open licensing.

As curator and author, I apply the Apache License, Version 2.0, at publication to permit reuse and implementation while preventing enclosure or patent capture. This licensing action does not revise, reinterpret, or supersede any normative content herein.

Authority remains explicitly human; no implementation, system, or platform may assert epistemic authority by virtue of this license.

Appendix sub-A - XDUMP (definition)

XDUMP is used to generate CM-artefacts that serialise session data

# XDUMP — Minimal Recovery Schema (Bag Model)
# Version: 1.12
# Status: normative (test)
# Purpose: last-resort, loss-intolerant session capture

XDUMP_ID = "XDUMP-DEFINITION-BAG-001"
ARTIFACT_TYPE = "XDUMP"
FORMAT = "TOML"
NORMATIVITY = "Normative"
BEST_EFFORT = "Required (Always)"
SELF_CONTAINED = true
CM_DEPENDENCY = "None"

PURPOSE = """
XDUMP is a minimal, self-contained recovery artefact intended to capture
all session-permitted material under degraded or hostile conditions.
Nothing encountered during the session may be silently omitted.
"""

[NORMATIVE_BLOCK — XDUMP_AUTHORITY_AND_RECOVERY]

1. AUTHORITY ORDER
   The following authority hierarchy SHALL apply to all XDUMP operations:

   1. Human Governor
   2. CM-master / CM-define governance
   3. XDUMP directives
   4. Control-plane state
   5. Tool-layer signals (file expiry, upload failure, UI loss)
   6. UI surface

   Tool-layer and UI signals SHALL NOT override human or CM-master authority.

2. XDUMP TRIGGER CONDITIONS
   An XDUMP SHALL be produced when ANY of the following occur:
   a) Human explicitly requests XDUMP.
   b) Session is declared NOBBLED by human or CM-master.
   c) Artefact availability is disputed between surfaces or tools.

3. BAG VS GAPS SEMANTICS
   a) The BAG SHALL contain only what is actually capturable.
   b) The GAPS SHALL narrate only what is missing, not what is inferred.
   c) GAPS SHALL NOT be used as permission to summarise or fabricate missing content.

4. ARTEFACT LOSS HANDLING
   If an artefact cannot be retrieved:
      - It SHALL be listed in GAPS.
      - Its last known identifier SHALL be preserved if known.
      - No speculative reconstruction SHALL occur.

5. CROSS-SURFACE CONTINUITY
   If multiple clients (e.g., Chrome, iPhone) participate in one CM session:
      - Each surface MAY emit its own XDUMP.
      - These XDUMPs SHALL be treated as shards of the same session.
      - No XDUMP may invalidate another unless explicitly superseded by human governor.

6. EXAMPLE-INJECTION RULE
   If a human injects an XDUMP example into a session:
      - That example SHALL be treated as authoritative reference.
      - The assistant SHALL conform its own XDUMP output to that example’s structure.

7. NON-COMPLIANCE
   Failure to produce a compliant XDUMP when required SHALL be recorded as:
      GAP = "XDUMP emission failure"
      Cause = "Control-plane or tool-layer non-compliance"

END NORMATIVE_BLOCK

# ------------------------------------------------------------------
# REQUIRED HEADERS (STRUCTURAL MINIMUM)
# ------------------------------------------------------------------
[REQUIRED_HEADERS]
H1 = "XDUMP_ID"
H2 = "ARTIFACT_TYPE"
H3 = "FORMAT"
H4 = "NORMATIVITY"
H5 = "BEST_EFFORT"
H6 = "METADATA"
H7 = "BAG"
H8 = "GAPS"
H9 = "FINAL_INFERENCE"

# ------------------------------------------------------------------
# INVARIANTS
# ------------------------------------------------------------------
[INVARIANTS]
I1 = "XDUMP MUST be self-contained and interpretable without CM or prior chat history."
I2 = "No silent omission: all encountered session material MUST appear in BAG or be marked in GAPS."
I3 = "Minimal structure, maximal coverage: BAG is the universal container."
I4 = "Structure MUST be preserved even under transport or UI degradation."
I5 = "If a concept cannot be classified, it MUST still be recorded with kind = 'UNCLASSIFIED'."
I6 = "Inference MUST be explicit; nothing implied by ordering or proximity."
I7 = "Completeness requirement: unrepresentable material MUST be marked UNRECORDED/UNKNOWN, never dropped."
I8 = "Episodic recording is mandatory: every session turn MUST yield at least one BAG item with kind = 'EPISODIC'."
I9 = "All derived conclusions MUST be recorded as BAG items with kind = 'INFERENCE'."

# ------------------------------------------------------------------
# METADATA (NON-SEMANTIC, DESCRIPTIVE)
# ------------------------------------------------------------------
[METADATA]
created_at = "ISO-8601 or UNKNOWN"
source_platform = "UNKNOWN | Chat | Other"
transport_status = "OK | NOBBLED | UNKNOWN"
scope_note = "Free text describing what this XDUMP attempts to cover"

# ------------------------------------------------------------------
# BAG — UNIVERSAL CONTAINER
# ------------------------------------------------------------------
# All session-permitted material is recorded here.
# Reconstruction is performed by filtering/sorting on fields.

[[BAG.item]]
id = "string-or-int"
kind = "EPISODIC | FACT | INFERENCE | CONSTRAINT | ARTEFACT | UNRESOLVED | METADATA | UNCLASSIFIED"
status = "CM_DEFINED | OBSERVED | INFERRED | UNRESOLVED | UNKNOWN | LOST"
episode_id = "int-or-null"        # link to episode / turn if applicable
turn_ordinal = "int-or-null"      # optional finer ordering
source = "human | system | artefact | mixed | unknown"
content = """Free text or structured payload"""
notes = "Optional clarifications, provenance, or derivation links"

# Repeat [[BAG.item]] as needed.
# Order is not authoritative; fields are.

# ------------------------------------------------------------------
# GAPS (MUST EXIST)
# ------------------------------------------------------------------
[GAPS]
# Explicitly list anything known to be missing or degraded.
# Example:
# turns_12_19 = "LOST: UI truncation"

# ------------------------------------------------------------------
# FINAL INFERENCE (MUST EXIST)
# ------------------------------------------------------------------
[FINAL_INFERENCE]
text = """
Single-paragraph synthesis of the session outcome.
Uncertainty MUST be stated explicitly.
"""

END = "END_OF_XDUMP_DEFINITION"