Skip to content

T8/P1.5: mutation-mode doctrine — scratch working copies vs append-only durable record (ADR-9) #52

Description

@mzargham

Owner direction (2026-08-02, post-LARP): make delete/edit-in-place vs append-new-triples fully explicit. Users get a real scratchwork mode (session staging / CLI working copy — full CRUD, 'cached content') or they will bypass controls; full commits produce append-only records (supersession markers, retraction markers, PROV) — the accountable durable trail. Emerged from LARP findings F-2/F-4/F-5 (#51).

Design (approved): stable IRIs + materialized markers (cds:supersededBy = owl:inverseOf cds:supersedes — which was never declared, fixed here; cds:retracted + cds:retractionReason); current view = graph-query filter (cds.core.view); ChangePlan commit gate (P2) written unconditionally as an artifact with approver IRI + content hash; approver-confirmed same-slug revisions; CLI warn-and-proceed on HEAD-committed rm; one kind-dispatched cds_discard + cds_retract (K1 whitelist 15→17, §8.1 amendment); ToolMode deontic enum READ/SCRATCH/APPEND/COMMIT; brief history appendix OFF by default (the model, not the document, is canon). Lineage constraints from dsg-ant-private adopted (claim-level markers; views as graph queries; scope IRIs = future named-graph URIs; per-frame shapes + union conflict checks; retraction referrer pre-check).

Also in scope: R6 = LARP mechanical fixes (F-1, F-3, F-6, F-7, F-11); R7 = perspective layer X2-lite (position record kind: stakeholder stances on shared frame objects; DivergingPositions as a finding, never a violation).

Tasks R0–R7 then LARP pass #2 then STOP before P2-a/b. Closes only when feat/t8-concept-definition-app merges to main.

Metadata

Metadata

Assignees

No one assigned

    Labels

    designt8T8 — LLM ergonomics + hosting (concept-definition web app)testing-hardening

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions