PHPackages                             infocyph/console - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. infocyph/console

ActiveLibrary

infocyph/console
================

A fast, expressive foundation for modern PHP command-line applications.

046↑2639.1%PHPCI passing

Since Jul 23Pushed yesterdayCompare

[ Source](https://github.com/infocyph/Console)[ Packagist](https://packagist.org/packages/infocyph/console)[ RSS](/packages/infocyph-console/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Infocyph Console
================

[](#infocyph-console)

A fast, typed foundation for building modern PHP command-line applications.

Current status
--------------

[](#current-status)

Phases 1–9 and 11 of the architecture are implemented:

- Typed command kernel, native argv parsing, and preflight help/list/version.
- Lazy InterMix command resolution with constructor injection and command scopes.
- Capability-aware text, ANSI, and JSON frame rendering.
- Typed terminal components for tables, trees, boxes, lists, status, progress, spinners, and task groups.
- Interactive and queued-test prompts with safe non-interactive fallbacks.
- ReqShield semantic validation with one-pass sanitized typed input and JSON validation failures.
- ArrayKit-backed lazy configuration and directly includable compiled command manifests for production preflight.
- Opt-in infrastructure services built on CacheLayer, DBLayer, EpiCrypt, OTP, Pathwise, TalkingBytes, and UID.
- A public testing API with in-memory command execution, prompt simulation, output and validation assertions, frame snapshots, and subprocess fixtures.
- Cross-platform hardening for CI and redirected terminals, global option validation, JSON error paths, subprocess environments, signal fallbacks, and workspace boundary checks.
- Initial scheduling primitives with cron frequencies, callbacks, overlap mutexes, and optional persistence; plus a production argv process runner with streaming, timeouts, cancellation, and redaction.
- Compiled validation-manifest loading, shell completion generation, themed ANSI rendering, semantic components, prompt hints/filtering, fuzzy suggestions, verbosity-aware diagnostics, and CI performance guardrails.

Production metadata and UX
--------------------------

[](#production-metadata-and-ux)

Use directly includable manifests to keep validation and completion in the preflight path:

```
$application = Application::configure()
    ->commandManifest(__DIR__.'/cache/commands.php')
    ->validationManifest(__DIR__.'/cache/validation.php')
    ->completionManifest(__DIR__.'/cache/completion.php')
    ->build();
```

`completion bash`, `completion zsh`, and `completion fish` emit installable shell definitions. Unexpected failures remain concise by default; `-v`, `-vv`, and `-vvv` add exception location and trace detail. Run `composer benchmark -- --enforce` to apply the CI performance ceiling locally.

Testing commands
----------------

[](#testing-commands)

```
$this->command('user:create')
    ->argument('email', 'hasan@example.com')
    ->option('age', 30)
    ->answer('Continue?', true)
    ->run()
    ->assertSuccessful()
    ->assertOutputContains('Created user hasan@example.com.');
```

Use the fluent API directly from Pest tests:

```
it('creates a user', function (): void {
    $application = Application::configure()
        ->commands([UserCreateCommand::class])
        ->build();

    $result = (new ApplicationTester($application))
        ->command('user:create')
        ->argument('email', 'hasan@example.com')
        ->run();

    $result->assertSuccessful();
});
```

`FakeTerminal`, `FakeClock`, `FakeKeyboard`, `FakeSignalManager`, `FakeCapabilityLoader`, `FrameSnapshot`, and `SubprocessRunner` cover terminal, lifecycle, and process-level scenarios. `CommandTestCase` remains available as a compatibility helper for consumers that use class-based tests.

Infrastructure capabilities
---------------------------

[](#infrastructure-capabilities)

Infrastructure is activated only after Console resolves the selected command. Preflight operations (`--version`, `list`, and help) never initialize it.

```
use Infocyph\Console\Command\Capability;
use Infocyph\Console\Otp\TotpVerifier;
use Infocyph\InterMix\DI\Container;

$application = Application::configure()
    ->otpVerifier(new TotpVerifier($totp))
    ->configureCapability(Capability::NETWORK, function (Container $container) use ($client): void {
        $container->definitions()->bind(\Infocyph\Console\Communication\RemoteClient::class,
            new \Infocyph\Console\Communication\RemoteClient($client));
    })
    ->build();
```

Commands declare their requirements in `define()`:

```
$command
    ->name('release:publish')
    ->capabilities([Capability::FILESYSTEM, Capability::NETWORK, Capability::IDENTITY])
    ->requiresOtp();
```

Reusable Console-specific services include `Workspace` for safe atomic files, `CommandStateStore` and `CommandMutex`, `DBLayerCommandHistoryRepository`, `SecretStore`, `SecureConfiguration`, `ArtifactVerifier`, `ReleaseSignatureVerifier`, and `RemoteClient`. Database connections and HTTP clients remain application-configured; Console never opens them automatically.

Framework integration
---------------------

[](#framework-integration)

Frameworks can provide their existing InterMix container and configuration repository without creating a second infrastructure graph. Providers remain lazy: version, help, list, and completion paths do not request either provider.

```
use Infocyph\Console\Application;

$application = Application::configure()
    ->containerProvider($frameworkContainerProvider)
    ->configurationProvider($frameworkConfigurationProvider)
    ->commands($commands)
    ->build();
```

`ContainerProvider::container()` is called only when a real command is dispatched. Console applies its configured providers and bindings once to each returned container, then creates a fresh command scope for every execution.

`ConfigurationProvider` owns profile selection and returns a `Configuration`. Use `Configuration::fromConfig()` to wrap an existing ArrayKit configuration repository without copying or eagerly materializing it. Local Console configuration layers, files, profiles, and validation cannot be combined with an external provider, avoiding ambiguous precedence.

```
use Infocyph\Console\Application;
use Infocyph\Console\Command\Command;
use Infocyph\Console\Command\CommandDefinition;
use Infocyph\Console\Command\ExitCode;

final class HelloCommand extends Command
{
    public static function define(CommandDefinition $command): void
    {
        $command->name('hello')->description('Say hello.');
    }

    protected function handle(): int
    {
        $this->io()->success('Hello!');

        return ExitCode::SUCCESS;
    }
}

$application = Application::configure()
    ->name('example')
    ->version('1.0.0')
    ->commands([HelloCommand::class])
    ->build();

exit($application->run());
```

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance65

Regular maintenance activity

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/33b750b84ab22f2038ef9b90ee48f2fcdaab6b5698e9f956a89a152466200b63?d=identicon)[abmmhasan](/maintainers/abmmhasan)

---

Top Contributors

[![abmmhasan](https://avatars.githubusercontent.com/u/7711128?v=4)](https://github.com/abmmhasan "abmmhasan (4 commits)")

### Embed Badge

![Health badge](/badges/infocyph-console/health.svg)

```
[![Health](https://phpackages.com/badges/infocyph-console/health.svg)](https://phpackages.com/packages/infocyph-console)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)