Export protocol v1.1 (the exit door) + partner-name scrub - #1
Draft
RegardsKiki2 wants to merge 1 commit into
Draft
Export protocol v1.1 (the exit door) + partner-name scrub#1RegardsKiki2 wants to merge 1 commit into
RegardsKiki2 wants to merge 1 commit into
Conversation
- SPEC-EXPORT.md: export records (evidence/territory/connection/reading), drop-file convention (*.bevia-export.jsonl), pull convention, and behavioral guarantees (provenance always carried, stable ids, event time, no verdicts, export never sold separately, pull-not-push). - schema/export-record.schema.json + a matching JSONL example, validated in CI line-by-line. - Genericize partner/product names across SPEC.md, schemas, examples, and reference/README.md; add them to the publish-guard forbidden patterns so they cannot re-enter. - README reframed around both doors: capture in, records out. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011dJA2L84s2PxJkAx87L9eZ
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this adds
The exit half of the protocol. SPEC.md §7 deferred the export-format spec to v1.1; this PR ships it:
SPEC-EXPORT.md— the public contract for building a consumer (any tool that reads what an engine has come to understand):evidence(the round-trip of intake),territory,connection,reading. Consumers skip unknown kinds, never fail.*.bevia-export.jsonl, one record per line, atomic writes, dedupe by stableid. The mirror of the intake drop-file.schema/export-record.schema.json+ a matching JSONL example, validated line-by-line in CI.Like the capture spec, this describes only the doors — nothing about how captures become understanding.
Partner-name scrub
Private partner and product names removed everywhere they appeared (reference/README.md, SPEC.md, both schemas, the robot example) and replaced with generic equivalents. The publish-guard workflow now includes those names in its forbidden-pattern scan so they cannot re-enter the repo.
Verification
🤖 Generated with Claude Code
https://claude.ai/code/session_011dJA2L84s2PxJkAx87L9eZ
Generated by Claude Code