Files
steev/docs/contracts/personal-agent-secondbrain-proposal-route.json

232 lines
8.2 KiB
JSON

{
"schema_version": "personal-agent-secondbrain-proposal-route/v1",
"status": "active-profile-memory-proposal-route",
"route_id": "personal-agent-secondbrain-proposal-route",
"profile_identity": "personal-agent",
"display_name": "Steev",
"observed_date": "2026-06-14",
"target_memory_domain": "secondbrain-personal",
"target_domain_term": "Personal Memory Domain",
"human_authority_principal": "jp",
"forbidden_memory_domains": [
"orgbrain"
],
"durable_write_allowed": false,
"direct_write_allowed": false,
"profile_runtime_readiness_claimed": false,
"secondbrain_runtime_readiness_claimed": false,
"seed_readiness_claimed": false,
"authority_boundary": {
"profile_owns_source_surface_exposure": true,
"secondbrain_owns_personal_memory_domain": true,
"curator_owns_hygiene_review_queue": true,
"capability_packages_emit_proposals_only": true,
"apply_owner": "secondbrain",
"hygiene_owner": "curator",
"notes": "personal-agent capability packages may emit redacted proposal envelopes. Secondbrain now defines the governed apply route; live durable Memory Object writes still require approval and Secondbrain evidence."
},
"source_routes": [
{
"source_surface": "imessage.read",
"capability_package": "bluebubbles",
"proposal_type": "secondbrain.memory.propose_create_from_imessage",
"secondbrain_intake_contract": "../secondbrain/docs/integration/2026-06-14-secondbrain-personal-agent-imessage-intake-contract.md",
"secondbrain_apply_contract": "../secondbrain/docs/integration/2026-06-14-secondbrain-personal-agent-imessage-apply-contract.md",
"target_lifecycle_state": "inbox",
"allowed_effects": [
"emit_redacted_proposal",
"emit_source_handle",
"emit_content_digest"
],
"denied_effects": [
"durable_memory_write",
"orgbrain_write",
"message_send",
"message_delete",
"message_mark_read",
"attachment_download"
]
},
{
"source_surface": "mail.read",
"capability_package": "proton-rclone",
"proposal_type": "secondbrain.memory.propose_create_from_mail",
"target_lifecycle_state": "inbox",
"allowed_effects": [
"emit_redacted_proposal",
"emit_source_handle",
"emit_content_digest"
],
"denied_effects": [
"durable_memory_write",
"orgbrain_write",
"mail_send",
"mail_delete",
"mail_mark_read"
]
},
{
"source_surface": "calendar.read",
"capability_package": "proton-rclone",
"proposal_type": "secondbrain.memory.propose_create_from_calendar",
"target_lifecycle_state": "inbox",
"allowed_effects": [
"emit_redacted_proposal",
"emit_source_handle",
"emit_content_digest"
],
"denied_effects": [
"durable_memory_write",
"orgbrain_write",
"calendar_write",
"calendar_delete"
]
},
{
"source_surface": "contacts.read",
"capability_package": "proton-rclone",
"proposal_type": "secondbrain.memory.propose_create_from_contacts",
"target_lifecycle_state": "inbox",
"allowed_effects": [
"emit_redacted_proposal",
"emit_source_handle",
"emit_content_digest"
],
"denied_effects": [
"durable_memory_write",
"orgbrain_write",
"contact_mutation",
"contact_delete"
]
},
{
"source_surface": "drive.read",
"capability_package": "proton-rclone",
"proposal_type": "secondbrain.memory.propose_create_from_drive_pointer",
"target_lifecycle_state": "inbox",
"allowed_effects": [
"emit_redacted_proposal",
"emit_source_handle",
"emit_content_digest"
],
"denied_effects": [
"durable_memory_write",
"orgbrain_write",
"drive_file_content_download",
"drive_file_name_proof",
"drive_write",
"drive_delete"
]
}
],
"proposal_envelope_contract": {
"schema_version": "personal-agent.secondbrain.proposal-envelope.v1",
"required_fields": [
"schema_version",
"proposal_id",
"profile_identity",
"human_authority_principal",
"target_memory_domain",
"target_domain_term",
"source_capability_package",
"source_surface",
"proposal_type",
"target_lifecycle_state",
"source_handle_redacted",
"content_digest",
"redacted_summary",
"changed_fields",
"validator_plan",
"rollback_note",
"approval_state",
"proof_redaction"
],
"target_memory_domain": "secondbrain-personal",
"target_domain_term": "Personal Memory Domain",
"approval_state": "pending",
"raw_payload_custody": "source-runtime-or-secondbrain-apply-route-only",
"raw_payload_in_core_or_profile_proof": false,
"durable_apply_authorized_by_envelope": false
},
"apply_policy": {
"apply_route": "Secondbrain governed memory write path",
"apply_route_contract": "../secondbrain/docs/integration/2026-06-14-secondbrain-personal-agent-imessage-apply-contract.md",
"governed_apply_route_defined": true,
"apply_allowed_now": false,
"live_apply_executed": false,
"durable_apply_without_approval": false,
"requires_secondbrain_validator": "python3 tools/validate_secondbrain_child.py",
"requires_focused_secondbrain_gate": true,
"focused_secondbrain_gate_command": "python3 tools/check_secondbrain_personal_agent_imessage_intake.py",
"focused_secondbrain_apply_gate_command": "python3 tools/check_secondbrain_personal_agent_imessage_apply.py",
"requires_human_or_governed_approval": true,
"requires_local_evidence_and_handoff": true,
"push_allowed": false
},
"rejection_cases": [
{
"case": "target_orgbrain",
"input_target": "orgbrain",
"result": "rejected",
"reason": "personal context cannot route to Organization Memory Domain"
},
{
"case": "direct_durable_write",
"requested_effect": "durable_memory_write",
"result": "rejected",
"reason": "capability packages emit proposal envelopes only"
},
{
"case": "raw_payload_in_core_or_profile_proof",
"requested_effect": "store_raw_payload_in_proof",
"result": "rejected",
"reason": "proof is redacted-only"
},
{
"case": "apply_without_approval",
"requested_effect": "secondbrain_apply",
"result": "blocked",
"reason": "Secondbrain governed apply requires approval and validators"
}
],
"referenced_secondbrain_contracts": [
"../secondbrain/docs/integration/2026-06-09-secondbrain-personal-memory-domain-runtime-contract.md",
"../secondbrain/docs/integration/2026-06-09-secondbrain-governed-agent-retrieval-contract.md",
"../secondbrain/docs/integration/2026-06-09-secondbrain-governed-memory-write-path-contract.md",
"../secondbrain/docs/integration/2026-06-09-secondbrain-curator-hygiene-queue-contract.md",
"../secondbrain/docs/integration/2026-06-09-secondbrain-hermes-runtime-boundary.md",
"../secondbrain/docs/integration/2026-06-14-secondbrain-personal-agent-imessage-intake-contract.md",
"../secondbrain/docs/evidence/2026-06-14-secondbrain-personal-agent-imessage-intake-proof.md",
"../secondbrain/docs/integration/2026-06-14-secondbrain-personal-agent-imessage-apply-contract.md",
"../secondbrain/docs/evidence/2026-06-14-secondbrain-personal-agent-imessage-apply-proof.md"
],
"proof_policy": {
"mode": "redacted-only",
"forbidden_fields": [
"raw_messages",
"message_text",
"mail_bodies",
"mail_subjects",
"sender_address",
"recipient_address",
"contact_details",
"calendar_event_details",
"drive_file_names",
"drive_file_contents",
"attachment_content",
"endpoint_payloads",
"credentials",
"secret_values"
]
},
"remaining_gates": {
"secondbrain_governed_apply_route": "defined-no-live-apply",
"secondbrain_imessage_intake_contract": "ready",
"secondbrain_durable_apply": "blocked-follow-up",
"curator_hygiene_apply_review": "blocked-follow-up",
"desktop_adapter_exposure": "blocked-follow-up",
"runtime_health_proof": "blocked-follow-up",
"seed_package_pickup": "blocked-follow-up"
}
}