Skip to content

feat(protocol): add append-only invariants and git merge support #5

@mmilanez

Description

@mmilanez

Problem

Append-only state files are central to the protocol, but the implementation should better protect them from accidental conflict markers, header rewrites, missing final newlines, and unsafe git merges.

Proposed change

Add protocol-level append-only invariants, git-substrate guidance for merge behavior, and validator checks for common corruption patterns.

Acceptance criteria

  • Kernel wording explains append-only correction by adding new entries, not rewriting history.
  • Git-substrate guidance covers safe merge behavior for append-only logs.
  • Validator tests catch conflict markers, duplicate top-level headers where relevant, and missing final newlines.
  • Documentation explains limitations and when human review is still required.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestprotocolProtocol rules or framework behaviorroadmapTracked work item on the project roadmap

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions