docs(threads-ot6): draft promotion-write ↔ weave seam contract

[BunsDev]

Current disposition (2026-09-17)

Contract language merged as 74a7840cf45f3e706378ba140909e2fcd33812b4.
threads-ot6 is complete for its language-only scope. The coven-memory mirror
is cmem-r59, verified directly with bd show cmem-r59 --json in that
repository's live Dolt database. Its title, seam description, and the linked
cmem-6gy notes identify cmem-r59/threads-ot6; the earlier passive-export
lookup could not establish absence. threads-5mn tracks this reference repair.

Coven #887 is closed for its protected-route criteria. Admission channel
recording landed in Threads #72. Promotion runtime conformance remains
threads-lm4, blocked by the absent authenticated authority/committed-Ward
state and daemon submission path. No promotion implementation or Phase-5
human acceptance is claimed.

The original publication record below is historical; its draft status,
unresolved mirror, and draft-only downstream descriptions are superseded.

---

Draft - language-only contract review, not runtime acceptance.

Refs: threads-ot6; coven-memory mirror ID UNRESOLVED (threads-5mn).
Repository-owned coven-memory planning documents track this seam as SEAM;
they do not establish a specific counterpart Bead ID.

Objective and scope

Define the promotion-write / weave contract in
docs/seam-promotion-write-contract.md: coven-memory chooses what to promote,
Threads supplies protected-write validation contracts, and the Coven daemon
owns authentication, staging, commit-time replay, writes, and audit persistence.
This PR does not implement a promotion command or a second audit store.

coven memory promote remains planned work. Channel::Deliberate is a
normative requirement for that future boundary, not observed daemon behavior.
The absent production submission path is tracked in threads-xpo.
ApprovalPath remains independent of Channel; the suggested
FamiliarCoherence { veto } default remains PROPOSED, not ratified policy.

Acceptance split

threads-ot6 was retargeted to language correctness on 2026-08-20. It requires
accurate future-versus-current wording, an explicit unresolved mirror reference,
a proposed default, and matching language-only acceptance in the document.
Runtime proof remains in threads-lm4 and its prerequisites; it is not a
prerequisite for reviewing specification language.

The runtime findings remain unresolved:

• threads-dgg / P0 threads-dgg: Remove protected SOUL.md from the proposal/approval pipeline coven#887: protected targets must not gain proposal
  write authority; draft fix: remove Tier-0 proposal authority coven#933 is a checkpoint, not closure.
• threads-980 / P0 threads-980: Require one typed terminal close for every opened veto window coven#886: every opened window needs exactly one typed
  terminal close; draft fix: require typed veto-window terminal closes coven#932 is a checkpoint, not closure.
• threads-xpo and threads-55s: supported deliberate-channel intake and
  auditable admission channels are still required.

No agent review substitutes for independent Nova review or Val's freeze.

Published review follow-up (2026-09-09)

The reviewed corrections are published at
a79dcc1763fa63dd02c0056c452f0ea7a0ef29e5 in
docs/seam-promotion-write-contract.md:

• Remove the unsupported mirror assertion and mark the implementation absent.
• Address the existing review comments and align section 7 with the retargeted
  language-only scope.
• Correct frayed-thread degradation versus typed rejection vocabulary and
  audit citations.
• Distinguish human/no-window ceremonies from veto-window lifecycle obligations,
  without allowing an existing window to lose its terminal close.
• Separate validator contracts from daemon-owned persistence.

These edits are committed and pushed. All four intervening maintainer correction
commits are preserved in the history; the merge retains the additional
human/no-window clarification. Agent language review is not a GitHub approval or contract freeze.
The exact mirror lookup remains open in threads-5mn; no ID was guessed.

Impact and evidence

This is documentation-only work: no public Rust, SQL, migration, identity,
credential, or runtime authority change. Sources consulted include
specs/PHASE-0-DESIGN.md, specs/PHASE-5-APPROVAL-SEMANTICS.md,
crates/coven-threads-core/src/{validate,audit,approval}.rs, the retargeted Bead,
and coven-memory's repository-owned docs/CATCHUP-PLAN-2026-07-24.md.
Local whitespace validation passed. There is no downstream conformance claim.
Rollback is limited to the documentation; unresolved runtime and human gates
remain unchanged.

---

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

[Copilot]

Pull request overview

Adds a draft seam-contract document defining the integration boundary between coven memory promote (substrate-side write production) and coven-threads/daemon weave enforcement (authority-side commit permission), aligning terminology with Phase-0/Phase-5 vocabulary.

Changes:

• Introduces a single contract doc covering boundary ownership, promotion channel expectations, target classification fork, fail-closed behavior, and audit expectations.
• Captures explicit cross-bead dependencies (threads-dgg, threads-980) as acceptance blockers.
• Notes an audit-legibility gap (memory_entry_admitted drops channel) as a follow-up.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[BunsDev]

Cody approved-continuation checkpoint: published draft corrections at b8c7532. The independent language review identified and this patch corrects caller-declared derived-target exemption, recorded-but-unvalidated provenance, omission of applicable explicit human authorization, inaccurate fray ordering/proposal eligibility, and unavailable evidence mapped to the wrong terminal reason. Opened-window vocabulary is now distinguished from human/no-window rejection, and implementation is explicitly subordinate to the governing contract.

Sources rechecked: RFC-0001 at OpenCoven/familiar-contract commit 13d150a32a817da19bb4e5053f2205b15db0bb0a (sections 3.4, 5.6, 5.6.1), existing Threads Phase-5 section 4 and validate.rs ordering. Only docs/seam-promotion-write-contract.md changed; git diff --check passed. No Rust/SQL, migration, frozen spec, runtime implementation or authority mechanism was changed. The default remains PROPOSED; source-attestation validation and applicable admission evidence are requirements, not claims that runtime support exists. Keep this PR draft pending attributable language agreement. Runtime acceptance stays in threads-lm4, the mirror stays unresolved under threads-5mn, and no Nova/Val gate is granted.