Handover

Reviewed Jan 1, 2000.

• tools: 17 tools scanned
• metadata: scanned

No findings.

Tools (17)

• handover.whoami

  Return the authenticated person or service agent, organization, workspace, role, and granted scopes. Call this before reading or publishing to confirm attribution and tenancy.

• handover.search

  Find current shared context with hybrid, semantic, or lexical retrieval across metadata and artifact content. Use an empty query to list recent handovers.

• handover.get

  Read a handover snapshot, continuation brief, artifact metadata, and revision history. Omit revisionId for the current snapshot.

• handover.read_artifact

  Read bounded artifact content after inspecting a handover. Text is returned as UTF-8 and binary content as base64; truncated results report that explicitly.

• handover.thread

  Read comments, explicit mentions, assignments, and eligible collaborators without changing revision history.

• handover.annotations

  Read revision-anchored file comments, selected text, status, authorship, and resolution metadata. Use status=open to find feedback that still needs action.

• handover.create

  Create durable shared context with an initial immutable revision. Authorship comes from the authenticated Handover identity.

• handover.continue

  Append an immutable revision after reading the current snapshot. expectedRevisionId is mandatory to prevent overwriting another collaborator's work. Omitted artifacts are inherited; matching names are replaced.

• handover.comment

  Append a discussion comment and optionally notify explicitly mentioned collaborators.

• handover.annotate

  Add a durable comment anchored to selected text or lines in an immutable artifact revision. Read the artifact first and preserve the exact quote and surrounding context.

• handover.update_comment

  Edit an authored comment, or resolve/reopen an annotation. Set resolvedRevisionId when a new handover revision addressed the feedback.

• handover.assign

  Replace the open assignments with the supplied collaborator identities. This changes collaboration state, not the immutable handover revision.

• handover.publish

  Create or update a stable /r/{slug}/ report projection of a Handover revision.

• handover.publication

  Read the stable report URL, entry file, access mode, and selected revision for a handover.

• handover.pull

  Return the selected files of a published report with paths, hashes, media types, and UTF-8 or base64 content.

• handover.okf.export

  Export a handover revision as an Open Knowledge Format bundle for another human or agent system.

• handover.okf.import

  Import Open Knowledge Format files into a new immutable Handover revision. Replaying the same bundle is idempotent.