Experimental command aliases
============================

RAFT's stable documentation uses the current top-level commands, such as
``raft check-manifest`` and ``raft project-status``. Those command names remain
the canonical RAFT 1.x interface.

The grouped commands on this page are experimental aliases for testing a
possible RAFT 2.0 command layout. They call the same implementation as the
stable commands, but the grouped names may change before RAFT 2.0.

To avoid confusing new users, these grouped aliases are not shown in the main
``raft --help`` command list. Each group still has its own help, for example
``raft manifest --help`` and ``raft module --help``.

Manifest
--------

.. list-table::
   :widths: 35 35 30
   :header-rows: 1

   * - Experimental alias
     - Stable command
     - Purpose
   * - ``raft manifest check``
     - ``raft check-manifest``
     - Validate a manifest TSV.
   * - ``raft manifest template``
     - ``raft manifest-template``
     - Print or write a starter manifest TSV.

Project
-------

.. list-table::
   :widths: 35 35 30
   :header-rows: 1

   * - Experimental alias
     - Stable command
     - Purpose
   * - ``raft project status``
     - ``raft project-status``
     - Summarize a project without modifying it.
   * - ``raft project init``
     - ``raft init-project``
     - Initialize a project from an init config.
   * - ``raft project package``
     - ``raft package-project``
     - Create a portable project archive.
   * - ``raft project load``
     - ``raft load-project``
     - Load a portable project archive.
   * - ``raft project push``
     - ``raft push-project``
     - Push a project archive or repository state.
   * - ``raft project rename``
     - ``raft rename-project``
     - Rename a project.

Modules
-------

.. list-table::
   :widths: 35 35 30
   :header-rows: 1

   * - Experimental alias
     - Stable command
     - Purpose
   * - ``raft module list``
     - ``raft available-modules``
     - List available modules.
   * - ``raft module load``
     - ``raft load-module``
     - Load a module into a project.
   * - ``raft module update``
     - ``raft update-modules``
     - Update loaded modules.
   * - ``raft module steps``
     - ``raft list-steps``
     - List processes and workflows from loaded modules.

Workflows
---------

.. list-table::
   :widths: 35 35 30
   :header-rows: 1

   * - Experimental alias
     - Stable command
     - Purpose
   * - ``raft workflow list``
     - ``raft available-workflows``
     - List or inspect off-the-shelf workflows.
   * - ``raft workflow run``
     - ``raft run-workflow``
     - Run an existing project workflow.

Datasets And Reports
--------------------

.. list-table::
   :widths: 35 35 30
   :header-rows: 1

   * - Experimental alias
     - Stable command
     - Purpose
   * - ``raft dataset load``
     - ``raft load-dataset``
     - Load a predefined dataset manifest and inputs.
   * - ``raft report generate``
     - ``raft generate-reports``
     - Launch or generate workflow reports.

Using aliases safely
--------------------

Use the stable commands for published protocols, automation shared with other
users, and long-lived documentation.

Use the grouped aliases when you want to test the possible RAFT 2.0 command
shape and provide feedback on whether the grouping makes the interface easier
to learn.