Method registerCommands

app/src/API/Handlers/SystemHandler.cpp:147–199

* @brief Registers all system.* commands with the global registry. */

 * @brief Registers all system.* commands with the global registry.
 */
void API::Handlers::SystemHandler::registerCommands()
{
  auto& registry = CommandRegistry::instance();

  registry.registerCommand(
    QStringLiteral("system.projectDir"),
    QStringLiteral("Return the loaded project's directory, file path, and file name. Use this "
                   "to resolve paths relative to the .ssproj (e.g. a sibling Python script) "
                   "before calling system.exec."),
    emptySchema(),
    &projectDir);

  registry.registerCommand(
    QStringLiteral("system.exec"),
    QStringLiteral("Launch a helper process (e.g. \"python\" with a script path). Control "
                   "script only -- rejected over the network/SDK. workingDir defaults to the "
                   "project directory. Returns a processId. The process is terminated "
                   "automatically when the device disconnects, the project changes, or the "
                   "app quits."),
    makeSchema(
      {
        {QStringLiteral("program"),
         QStringLiteral("string"),
         QStringLiteral("Executable to run (resolved from PATH or an absolute path)")}
  },
      {{QStringLiteral("args"), QStringLiteral("array"), QStringLiteral("Command-line arguments")},
       {QStringLiteral("workingDir"),
        QStringLiteral("string"),
        QStringLiteral("Working directory (defaults to the project directory)")}}),
    &exec);

  registry.registerCommand(
    QStringLiteral("system.kill"),
    QStringLiteral("Terminate a managed helper process by id. Control script only."),
    makeSchema({
      {QStringLiteral("processId"), QStringLiteral("integer"), QStringLiteral("Process id")}
  }),
    &kill);

  registry.registerCommand(
    QStringLiteral("system.runningProcesses"),
    QStringLiteral("List the helper processes currently managed by system.exec."),
    emptySchema(),
    &runningProcesses);

  registry.registerCommand(
    QStringLiteral("system.startDemo"),
    QStringLiteral("Start the bundled zero-hardware rocket-launch demo: stages the demo "
                   "project, opens it, and connects the simulated source so the dashboard "
                   "streams live data. Unavailable in operator deployments."),
    emptySchema(),
    &startDemo);
}