Skip to content

Add SourceOS exactness, stale-state, and local-first reasoning-failure contracts #92

@mdheller

Description

@mdheller

Parent

SocioProphet/sociosphere#271

Purpose

Capture SourceOS-side contracts for reasoning-failure classes that must be enforced locally: exact strings, stale state, local-first sync, memory contamination, repair evidence, and deterministic verification.

Scope

Add or extend contracts/docs for:

  • exactness-sensitive artifacts: IDs, filenames, checksums, signatures, versions, package names, YAML/TOML/JSON, config fields, boot/release refs;
  • stale-state and validity-interval metadata;
  • observed time vs event time vs valid time;
  • local-first contradiction and conflict records;
  • repair-plan linkage for reasoning-derived state errors;
  • deterministic verifier receipts for string/counting/schema/policy checks;
  • source-channel envelopes carrying reasoning-failure refs;
  • memory/context hydration boundaries for SourceOS local services.

Acceptance criteria

  • SourceOS contracts distinguish durable, rebuildable, and disposable state for reasoning-failure evidence.
  • Exactness-sensitive mutations require deterministic verifier evidence and cannot be admitted from model text alone.
  • Contract examples cover stale state, string exactness failure, checksum mismatch, conflicting local object facts, and repair-plan preview.
  • Downstream sourceos-syncd, agent-machine, sourceos-devtools, AgentPlane, Policy Fabric, and Sociosphere integration points are documented.
  • No contract grants live mutation authority by itself.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions