phacility/phabricator · error · PhutilArgumentUsageException

Specify one or more repositories to correct reachability sta

Error message

Specify one or more repositories to correct reachability status for.

What it means

Usage error from `bin/repository mark-reachable`: `loadRepositories($args, 'repos')` returned an empty list. The workflow recomputes unreachable-commit flags per repository, so it needs at least one repository argument before calling `markReachable()`.

Source

Thrown at src/applications/repository/management/PhabricatorRepositoryManagementMarkReachableWorkflow.php:27

    $this
      ->setName('mark-reachable')
      ->setExamples('**mark-reachable** [__options__] __repository__ ...')
      ->setSynopsis(
        pht(
          'Rebuild "unreachable" flags for commits in __repository__.'))
      ->setArguments(
        array(
          array(
            'name' => 'repos',
            'wildcard' => true,
          ),
        ));
  }

  public function execute(PhutilArgumentParser $args) {
    $repos = $this->loadRepositories($args, 'repos');
    if (!$repos) {
      throw new PhutilArgumentUsageException(
        pht(
          'Specify one or more repositories to correct reachability status '.
          'for.'));
    }

    foreach ($repos as $repo) {
      $this->markReachable($repo);
    }

    echo tsprintf(
      "%s\n",
      pht(
        'Examined %s commits already in the correct state.',
        new PhutilNumber($this->untouchedCount)));

    echo tsprintf(
      "%s\n",
      pht('Done.'));

View on GitHub (pinned to 5720a38cfe)

Solutions

Pass repository callsigns/IDs: `./bin/repository mark-reachable R1 R2`.
For all repos, enumerate with `./bin/repository list` and pass every callsign.
Verify the identifiers if arguments seem to be dropped.

Example fix

// before
$ ./bin/repository mark-reachable
[1174] Specify one or more repositories to correct reachability status for.

// after
$ ./bin/repository mark-reachable R1

Defensive patterns

Strategy: validation

Validate before calling

REPOS="$(./bin/repository list | awk '{print $1}' | grep -v '^r' | tr '\n' ' ')"
./bin/repository mark-reachable $REPOS   # note: excludes SVN, see [1175]

Prevention

Pass explicit repository callsigns; the tool never sweeps all repos by itself.
Filter out SVN repositories when scripting across mixed installs.

When it happens

Trigger: Running `./bin/repository mark-reachable` with no arguments; passing identifiers that fail to resolve.

Common situations: Operators expect a whole-install reachability sweep and omit targets; the callsign is misspelled so nothing resolves.

Understand the failure class

Background: "missing required argument" and "the following required arguments were not provided": what required-argument errors mean and how to fix them — this error's family across 20 libraries.

Related errors

AI-assisted analysis of phacility/phabricator@5720a38cfe (2026-08-21). Data as JSON: /api/errors/2002f292c4e7f739. Report an issue: GitHub.