Skip to content

Surface Parity Matrix

Every public engine operation across the two programmatic surfaces (MCP, CLI). Rows are aligned by the hand-maintained xtask/operations.toml registry; cells render the surface-specific name when present and when the surface doesn’t expose the operation. The Registry HTTP surface is its own publication layer and not in this matrix.

OperationMCPCLI
entity-readmemstead_entityentity
searchmemstead_searchsearch
listlist
relations-readrelations
contextcontext
overviewmemstead_overviewoverview
statusstatus
schema-describememstead_schematype
healthmemstead_healthhealth
changes-sincememstead_changes_sincechanges
reloadmemstead_reloadreload
fetchfetch
pullpull
pushpush
branch-resetbranch-reset
creatememstead_createcreate
updatememstead_updateupdate
relatememstead_relaterelate
deletememstead_deletedelete
renamememstead_renamerename
mem-creatememstead_mem_createmem
mem-deletememstead_mem_deletemem
mem-set-versionmemstead_mem_set_versionmem
workspace-allow-createworkspace
workspace-revoke-createworkspace
workspace-allow-deleteworkspace
workspace-revoke-deleteworkspace
workspace-grant-cross-linkworkspace
workspace-revoke-cross-linkworkspace
projection-briefprojection brief
projection-initprojection init
projection-advanceprojection advance
projection-enableprojection enable
projection-editprojection edit
projection-excludeprojection exclude
projection-verifyprojection verify
projection-check-pathprojection check-path
parse-recoveryrecover
agent-notes
mem-head-sha

† These absences are decisions, not gaps. Every other empty cell is simply an operation that surface does not carry.

  • workspace-allow-create — workspace policy decides what an agent may do, so it is an operator surface: the CLI and the operator-authenticated web API, never the agent’s MCP surface. A policy-gated mutation refuses with the exact command to report.
  • workspace-revoke-create — workspace policy decides what an agent may do, so it is an operator surface: the CLI and the operator-authenticated web API, never the agent’s MCP surface. A policy-gated mutation refuses with the exact command to report.
  • workspace-allow-delete — workspace policy decides what an agent may do, so it is an operator surface: the CLI and the operator-authenticated web API, never the agent’s MCP surface. A policy-gated mutation refuses with the exact command to report.
  • workspace-revoke-delete — workspace policy decides what an agent may do, so it is an operator surface: the CLI and the operator-authenticated web API, never the agent’s MCP surface. A policy-gated mutation refuses with the exact command to report.
  • workspace-grant-cross-link — workspace policy decides what an agent may do, so it is an operator surface: the CLI and the operator-authenticated web API, never the agent’s MCP surface. A policy-gated mutation refuses with the exact command to report.
  • workspace-revoke-cross-link — workspace policy decides what an agent may do, so it is an operator surface: the CLI and the operator-authenticated web API, never the agent’s MCP surface. A policy-gated mutation refuses with the exact command to report.

Surface entries the registry does not pin to a logical operation. Either add a row to xtask/operations.toml or, if the entry is intentionally surface-local (e.g. CLI-only registry / setup commands), leave it here as a deliberate gap.

  • memstead_check
  • memstead_diff
  • memstead_mem_configure
  • memstead_mem_set_schema
  • memstead_retype
  • anchors
  • batch-create
  • batch-relate
  • batch-update
  • check
  • conflicts
  • due
  • export
  • gates
  • init
  • install
  • login
  • logout
  • mem-repo
  • publish
  • quickstart
  • retype
  • review-mark
  • schema
  • uninstall
  • unpublish
  • verify-anchors