Function get_commands

src/command_system/aggregator.py:86–134

Return commands available to the current user for ``cwd``. Merges builtins (fresh) + filesystem skills (cached by cwd), then filters by availability + is_enabled FRESH on every call so auth/flag changes take effect immediately. De-duplicated by name (builtins own their names — see

(
    cwd: str | Path | None = None,
    *,
    is_claude_ai_subscriber: bool = False,
    is_console_user: bool = False,
)

def get_commands(
    cwd: str | Path | None = None,
    *,
    is_claude_ai_subscriber: bool = False,
    is_console_user: bool = False,
) -> list[Command]:
    """
    Return commands available to the current user for ``cwd``.

    Merges builtins (fresh) + filesystem skills (cached by cwd), then filters by
    availability + is_enabled FRESH on every call so auth/flag changes take effect
    immediately. De-duplicated by name (builtins own their names — see below).

    Port of commands.ts:500 getCommands(cwd).
    """
    cwd_key = str(cwd) if cwd is not None else str(Path.cwd())

    # Builtins fresh (re-evaluates conditional appends); skills cached by cwd.
    all_commands: list[Command] = [
        *get_builtin_commands(),
        *_load_workflow_commands_cached(cwd_key),
        *_load_skill_commands_cached(cwd_key),
    ]

    seen: set[str] = set()
    result: list[Command] = []
    for cmd in all_commands:
        if cmd.name in seen:
            continue  # name already claimed by an earlier command
        # Reserve the name BEFORE filtering: a builtin owns its name even when it is
        # disabled/unavailable, so a same-named skill (enumerated later) can never
        # shadow it. Builtins are enumerated first -> builtins win. This diverges
        # from TS's filter-then-dedupe order on purpose (prevents a user skill named
        # `help`/`clear` from shadowing a core builtin).
        #
        # This assumes filter-gated builtins (is_enabled / availability) are never
        # meant to be *replaced* by a same-named skill. A command that should yield
        # to a skill must instead be omitted from the source list entirely (an
        # "append-gate", like buddy's is_buddy_command_enabled()), so it never
        # reaches this loop and never reserves its name.
        seen.add(cmd.name)
        if not meets_availability_requirement(
            cmd, is_claude_ai_subscriber, is_console_user
        ):
            continue
        if not is_command_enabled(cmd):
            continue
        result.append(cmd)
    return result


@lru_cache(maxsize=32)