Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript
11.3 KB
Raw Blame
# Managed-brain census of mutating operations and CLI-only writers (fix wave 3).
# Every operation with `mutating: true` in the assembled registry needs a row; test/canonical-writer-inventory.test.ts enforces it.
# kind	name	class	reason
# class: coordinator (publishes through the persistence coordinator), no_canonical_write (writes no guarded canonical table or file),
#        early_refusal (refuses on a managed brain before any write), engine_guard (the managed writer trigger refuses its canonical write).
op	remember	coordinator	submitRememberMutation admits a journaled page mutation.
op	forget	coordinator	submitForgetMutation records a coordinated withdrawal.
op	memory_write	coordinator	Each fact is a remember write (submitRememberMutation) under a per-member child request id.
op	memory_propose	no_canonical_write	Inserts one memory_proposals row awaiting the owner; no page changes until gbrain memory-proposals approve admits the held write to the journal under the proposal's stored authority.
op	put_page	coordinator	submitPageMutation; unbound Postgres sources refuse unless persistence.unbound_write=database_only.
op	put_pages	coordinator	Every page is admitted as its own coordinated put_page write request, together in one journal transaction (#6007)
op	storage_register	coordinator	submitPageMutation through the storage door (trusted local only); on a hosted shelf the card commits to its repository before it is indexed.
op	storage_update	coordinator	submitPageMutation through the storage door bound to expected_revision (trusted local only); on a hosted shelf the change commits before it is indexed.
op	delete_page	coordinator	submitPageMutation soft delete or trusted-local purge.
op	restore_page	coordinator	submitPageMutation restores a recorded version.
op	purge_deleted_pages	coordinator	purgeDeletedPagesCoordinated purges each expired tombstone through delete_page purge.
op	promote_guest_note	coordinator	Writes the owner page through submitPageMutation put_page and records the link in guest_promotions; the guest note is never changed.
op	capture	coordinator	submitPageMutation admits a journaled page mutation.
op	cancel_write_request	no_canonical_write	Cancels a queued journal request; no canonical row changes.
op	add_tag	coordinator	submitPageMutation admits a journaled page mutation.
op	remove_tag	coordinator	submitPageMutation admits a journaled page mutation.
op	add_link	coordinator	submitPageMutation admits a journaled page mutation of the from page's links fence; the edge is projected from it.
op	remove_link	coordinator	submitPageMutation, same boundary as add_link; the apply also deletes the matching database-only edges.
op	add_timeline_entry	coordinator	submitPageMutation admits a journaled page mutation.
op	revert_version	coordinator	submitPageMutation admits a journaled page mutation.
op	edit_page	coordinator	submitPageMutation admits a journaled page mutation; edits apply to the locked snapshot.
op	append_page	coordinator	submitPageMutation admits a journaled page mutation; the append applies to the locked snapshot.
op	begin_page_upload	no_canonical_write	Opens an upload session row; no page is written until commit_page_upload.
op	upload_page_part	no_canonical_write	Stages one part of an upload session; no page is written until commit_page_upload.
op	commit_page_upload	coordinator	submitPageMutation admits the staged body as a journaled page mutation (put_page, or append_page in append mode).
op	abort_page_upload	no_canonical_write	Discards an uncommitted upload session and its staged parts; no page is written.
op	put_skill	coordinator	Shared-skill publication through the persistence journal.
op	delete_skill	coordinator	Shared-skill publication through the persistence journal.
op	set_skill_policy	no_canonical_write	Shared-skill policy row, epoch-guarded; no page content.
op	prune_skill_revisions	no_canonical_write	Shared-skill revision retention only.
op	retain_skill_revision	no_canonical_write	Shared-skill revision retention only.
op	import_skill_proposal	coordinator	Imports a proposal through shared-skill publication.
op	join_brain	no_canonical_write	Mount registration in local configuration.
op	sync_brain_skills	no_canonical_write	Refreshes mounted skill copies outside the brain database.
op	leave_brain	no_canonical_write	Mount removal in local configuration.
op	sync_brain	coordinator	Managed sync admits each changed file through the coordinator.
op	put_raw_data	no_canonical_write	raw_data side table; not guarded canonical content.
op	log_ingest	no_canonical_write	ingest_log audit rows only.
op	file_upload	no_canonical_write	File storage objects and their index rows, confined to the upload root.
op	file_register	no_canonical_write	A files index row for an object an embedded host already stored at the upload layout path.
op	submit_job	no_canonical_write	Queues a minion job; its handler owns any write and its own boundary.
op	cancel_job	no_canonical_write	Minion queue state only.
op	retry_job	no_canonical_write	Minion queue state only.
op	pause_job	no_canonical_write	Minion queue state only.
op	resume_job	no_canonical_write	Minion queue state only.
op	watch_job	no_canonical_write	Wake subscription state only (wake_subscriptions).
op	unwatch	no_canonical_write	Wake subscription state only (wake_subscriptions).
op	watch_write_request	no_canonical_write	Wake subscription state only (wake_subscriptions).
op	watch_cron	no_canonical_write	Wake subscription state only (wake_subscriptions).
op	accept_wakeshift_terms	no_canonical_write	Wakeshift terms acceptance state only (wake_terms_acceptances).
op	replay_job	no_canonical_write	Minion queue state only.
op	send_job_message	no_canonical_write	Minion inbox rows only.
op	submit_agent	no_canonical_write	Queues a subagent job; its tools write through put_page.
op	think	engine_guard	Remote callers are read-only; a local --save persists through engine.putPage, which the managed writer trigger refuses on a managed brain.
op	takes_add	coordinator	submitPageMutation takes intent.
op	takes_update	coordinator	submitPageMutation takes intent.
op	takes_resolve	coordinator	submitPageMutation takes intent.
op	takes_remove	coordinator	submitPageMutation takes intent; local-only removal of one fence row and its takes row.
op	takes_supersede	coordinator	submitPageMutation takes intent.
op	takes_rebuild	coordinator	Local-only rebuild of one page's takes index from its fence (W9F item 8); on a managed brain reextractCoordinated publishes it inside a withCoordinatedWrite transaction (receipted takes intent: Lane R).
op	sources_add	early_refusal	Deliberate administrative refusal on managed brains; source topology changes through writer administration.
op	sources_remove	early_refusal	Deliberate administrative refusal on managed brains; source topology changes through writer administration.
op	request_tools	no_canonical_write	Persists the calling client's MCP tool surface on oauth_clients.
op	connector_sync	coordinator	Managed connector sync admits pages and checkpoints through the coordinator.
op	ontology_propose	engine_guard	mergeOntologyFact inserts into facts; the managed writer trigger refuses it on a managed brain.
op	chronicle_backfill	no_canonical_write	Queues chronicle jobs; the chronicle extractor publishes through publishMaintenancePage.
op	extract_entities	coordinator	#6262: the stub is a create-only put_page through submitPageMutation; its tier lowering, timeline row and backlink are coordinatedDatabaseWrite transactions. A refusal or pending write returns its envelope and stops the batch.
op	extraction_review	coordinator	Promote, reject and distinct publish through the page-mutation door (edit_page / delete_page).
op	entity_identity_link	no_canonical_write	entity_identity side table.
op	entity_identity_unlink	no_canonical_write	entity_identity side table.
op	extract_facts	coordinator	The facts backstop publishes through the managed facts session on managed brains.
op	forget_fact	coordinator	submitForgetMutation records a coordinated fact withdrawal.
op	code_traversal_cache_clear	no_canonical_write	Derived traversal cache only.
op	migrate_embeddings	no_canonical_write	Embedding projections under the migration budget; no canonical content.
op	schema_apply_mutations	no_canonical_write	Schema-pack files outside the brain database.
op	run_onboard	no_canonical_write	Runs remediation steps; each step keeps its own writer boundary.
op	run_skillopt	no_canonical_write	Skill files and proposals outside the brain database.
op	loops_close	coordinator	open_loops state rows; the commitment fact is retired (expired, fence row struck) through the loop-fact-retirement coordinator mutation (#5869).
op	loops_mute	no_canonical_write	Loop suppression rows.
op	memory_conversation_mode	no_canonical_write	Returns the rule for the rest of the calling conversation; stores nothing.
op	set_memory_writeback	no_canonical_write	memory.agent_writeback config row plus an mcp_request_log audit row; no page content.
op	mute_notice	no_canonical_write	Notice mute list in <GBRAIN_HOME>/notices/muted.json; no brain table or canonical file.
op	questions_pin	coordinator	pinned_questions side-table rows; the question page publishes through coordinated put_page (trusted local callers only).
op	questions_refresh	coordinator	Answer and evidence pointers in the pinned_questions side tables; question page sync through coordinated put_page (trusted local callers only).
op	questions_unpin	coordinator	pinned_questions state; the question page is archived through coordinated put_page (trusted local callers only).
op	loops_unmute	no_canonical_write	Loop suppression rows.
op	rate_answer	no_canonical_write	Writes only retrieval_* feedback tables (answer ratings and learned weights), never a guarded canonical table or file.
op	purge_fact	coordinator	submitPurgeFactMutation admits a journaled write and deletes the purged rows under withCoordinatedWrite (trusted local CLI only).
op	unpurge_page	no_canonical_write	Deletes only purge tombstone rows (page_purges, fact_purges, take_purges); restores no canonical row (trusted local CLI only).
op	confirm_memory	coordinator	applyOwnerAction raises the row to user_confirmed through the owner action path (journaled owner page mutation or withCoordinatedWrite on a managed brain).
cli	src/commands/enrich.ts	coordinator	gbrain enrich preflights maintenance authority, then publishMaintenancePage per page.
cli	src/commands/extract-conversation-facts.ts	coordinator	Bulk conversation facts publish in batches of pages as receipted managed_maintenance_conversation_facts requests after a maintenance preflight.
cli	src/commands/pages.ts	coordinator	gbrain pages purge-deleted runs purgeDeletedPagesCoordinated.
cli	src/core/bootstrap/verify.ts	coordinator	gbrain bootstrap verify writes probes with put_page and purges them through delete_page purge.
cli	src/core/google/loops-extract.ts	coordinator	Loop commitments publish through writeSingleFact's managed facts path.
cli	src/core/facts/fence-write.ts	coordinator	Direct fence writes publish through publishManagedEntityFacts.
cli	src/core/chronicle/extract-events.ts	coordinator	Chronicle events and their depth timeline rows publish through publishMaintenancePage.
cli	src/core/persistence/purge-deleted.ts	coordinator	Shared purge used by the cycle, the purge job, the operation and the CLI.
cli	src/commands/sources-refresh.ts	coordinator	gbrain sources refresh drains and fences the worktree, fast-forwards it under the native lock, then imports through the managed --no-pull sync's journaled page requests.