cluster_rebind
Propose, apply, list orphan papers, or check rebind status for paper-to-cluster moves in one action-based workflow.
Instructions
Run the cluster-rebind workflow specified by action.
Single entrypoint that consolidates four legacy rebind operations
(propose / apply / list_orphans / status) into one tool with an
action discriminator. Replaces the deprecated aliases
propose_cluster_rebind / apply_cluster_rebind /
list_orphan_papers / summarize_rebind_status, which are
gated behind RESEARCH_HUB_MCP_INCLUDE_DEPRECATED=1 and slated
for removal in v2.0.0.
When to use:
After ingest leaves orphan paper notes that don't match any active cluster, and you want to plan moves before touching files.
After a manual cluster rename, when existing paper notes still reference the old slug.
Periodic vault hygiene: surface stuck or low-confidence orphans via
action='status'.
When NOT to use:
You want to delete clusters wholesale, not rebind their papers; use
research-hub clusters delete(CLI) instead.You want to archive papers carrying a label; use
prune_clusterinstead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Which rebind sub-step to run. One of: ``'propose'`` (write a draft rebind report to disk), ``'apply'`` (execute moves from a report — requires ``report_path``), ``'list_orphans'`` (return orphan paper paths, optionally filtered by ``folder``), or ``'status'`` (one-shot summary of orphans + open proposals). Defaults to ``'propose'``. | propose |
| cluster_slug | No | Limit ``propose`` / ``status`` to one cluster's papers. Empty string (default) means all clusters. | |
| report_path | No | Path to a rebind report emitted by a prior ``action='propose'``. Required for ``action='apply'``; ignored otherwise. | |
| dry_run | No | When ``action='apply'``, report the moves without touching the filesystem. Defaults to ``True`` — pass ``False`` to actually move files. | |
| auto_create_new | No | When ``action='apply'``, allow the apply step to create previously-unknown cluster folders for high-confidence new-cluster proposals. Defaults to ``False``. | |
| folder | No | When ``action='list_orphans'``, restrict the result to papers under this ``raw/`` subdirectory. Empty string (default) returns all orphans. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||