qzx listCommands

Exemplo de saída observada

Capturado com QZX 0.2.2.0.9 no Windows 11; código de saída 0. Valores dependentes do host e a duração podem variar.

Comando do exemplo: qzx listCommands --json

{
    "success": true,
    "message": "Available Commands\nCommands: 89",
    "summary": {
        "commands": 89,
        "categories": 4,
        "filter": null
    },
    "maturity_summary": {
        "alpha": 89
    },
    "commands": {
        "system": [
            {
                "name": "about",
                "description": "Displays QZX product, creator, maintainer, and license details",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "checkExecutable",
                "description": "Locates an executable in the system PATH and optionally reads its conventional --version output",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "checkSystemPath",
                "description": "Diagnoses the system PATH variable, lists broken or duplicate folders, and locates all instances of a binary",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "clearScreen",
                "description": "Clears an interactive terminal directly without spawning cls, clear, or a command shell",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "diagnoseStorage",
                "description": "Diagnoses storage pressure by combining disk capacity, large-file discovery, and byte-verified duplicate analysis without deleting anything",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "explainFileWithGemini",
                "description": "Previews and optionally sends bounded file samples to Google Gemini for explanation",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getCpuLoad",
                "description": "Gets information about current CPU usage",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getCurrentDateTime",
                "description": "Reports the current local date and time with timezone, calendar, ISO-week, and timestamp details",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getCurrentDirectory",
                "description": "Shows the current working directory",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getCurrentUser",
                "description": "Gets information about the currently logged in user",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getDiskHealth",
                "description": "Inspects one disk's S.M.A.R.T. health with smartctl and reports status flags without treating health warnings as command failures",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getDiskSpace",
                "description": "Gets information about disk space usage",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getGpuInfo",
                "description": "Inspects installed GPUs and reports normalized vendor, driver, memory, and available utilization details",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getRamInfo",
                "description": "Gets detailed information about system RAM usage",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getSystemInfo",
                "description": "Gets portable operating-system, Python, user, and environment information with optional RAM and storage details",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "help",
                "description": "Shows help for a command",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "inspectPort",
                "description": "Checks whether a local port is bound and reports the owning process without terminating it",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "isAdmin",
                "description": "Checks if the current user has administrative privileges",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "killProcess",
                "description": "Terminates one explicitly identified process and verifies that it exited",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "listCommands",
                "description": "Lists all available commands organized by category",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "listDiskDevices",
                "description": "Gets disk name/model information for a disk or all disks",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "listProcesses",
                "description": "Lists running processes (similar to 'ps' in Unix)",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "listStartupPrograms",
                "description": "Lists all startup programs configured to run on system boot or user login",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "listSystemServices",
                "description": "Lists operating-system services and their running status",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "runDiagnosticCommand",
                "description": "Runs a strictly read-only native system diagnostic from a platform-specific allowlist",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "runScript",
                "description": "Executes one explicit Python, Bash, or Windows Batch script with a timeout and bounded retained output",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "systemDoctor",
                "description": "Performs a complete diagnostic of the CPU, RAM, disks, network, PATH, services, ports, and system errors",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "terminal",
                "description": "Launches an interactive terminal/shell for QZX commands",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "testDiskSpeed",
                "description": "Measures sequential durable-write and buffered-read throughput in MiB/s using a uniquely named temporary file",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "version",
                "description": "Displays the installed QZX version and product identity",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "welcome",
                "description": "Introduces QZX with a read-only first-success path and optional system details",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            }
        ],
        "development": [
            {
                "name": "addPythonDocstrings",
                "description": "Previews or adds generated docstring templates to functions, methods, and classes in one Python file",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "analyzeComplexity",
                "description": "Analyzes code complexity metrics for files or projects",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "auditRepository",
                "description": "Runs security and quality audits on a Git repository (secrets, large files, duplicates, .gitignore compliance, licenses)",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "cleanDevelopmentArtifacts",
                "description": "Finds development caches, dependency directories, and generated build artifacts; preview is the default",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "compareFiles",
                "description": "Compares text files line by line and binary files by exact bytes and SHA-256",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "deployProject",
                "description": "Previews or deploys one explicit artifact over SSH using a verified remote backup, SHA-256 validation, atomic promotion, health checks, and automatic rollback",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "diagnoseProject",
                "description": "Inspects project technologies, dependencies, validation workflows, Git state, source quality, and large files without executing project scripts",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "findUnusedCode",
                "description": "Finds functions, classes, and exports with no statically visible references so they can be reviewed for removal",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "formatCode",
                "description": "Formats source code files by auto-detecting language and invoking the right formatter",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getGitStatus",
                "description": "Provides a structured summary of the Git repository state (branch, remote, changes, recent commits)",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getProjectTree",
                "description": "Generates one bounded ASCII and JSON directory tree without following descendant symbolic links",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "planProjectBootstrap",
                "description": "Builds a selectable project bootstrap plan without writing files, installing dependencies, creating secrets, or running migrations",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "prepareRelease",
                "description": "Plans a release metadata update and can atomically update one manifest plus CHANGELOG.md; it never builds, commits, tags, or publishes",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "projectLanguages",
                "description": "Profiles a project's source languages and supporting formats with line, file, and byte percentages",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldC",
                "description": "Creates a basic scaffolding for a C program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldCpp",
                "description": "Creates a basic scaffolding for a C++ program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldCSharp",
                "description": "Creates a basic scaffolding for a C# program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldGo",
                "description": "Creates a basic scaffolding for a Go program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldJava",
                "description": "Creates a basic scaffolding for a Java program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldJavaScript",
                "description": "Creates a basic scaffolding for a JavaScript/Node.js program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldKotlin",
                "description": "Creates a basic scaffolding for a Kotlin program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldPhp",
                "description": "Creates a basic scaffolding for a PHP/Composer program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldPython",
                "description": "Creates a basic scaffolding for a Python program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldRust",
                "description": "Creates a basic scaffolding for a Rust program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "scaffoldTypeScript",
                "description": "Creates a basic scaffolding for a TypeScript program",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "traceCircularImports",
                "description": "Traces module imports recursively and identifies circular import dependencies (loops)",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "traceEnvVar",
                "description": "Traces usage of an environment variable across code files, .env, and .env.example templates",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            }
        ],
        "file": [
            {
                "name": "auditWorkspace",
                "description": "Builds a deterministic, fingerprinted workspace cleanup plan without altering workspace contents",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "calculateFileHash",
                "description": "Calculates cryptographic hashes (MD5, SHA-1, SHA-256) of a file",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "changePermissions",
                "description": "Changes permissions of a file or directory",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "copyPath",
                "description": "Copies one file, symbolic link, or directory to a separate destination with explicit depth and replacement behavior",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "countLines",
                "description": "Counts logical Unicode lines in a stable regular file using bounded-memory streaming and explicit newline evidence",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "createDirectory",
                "description": "Creates one or more real directories with deduplication, conflict detection, and per-target rollback on failure",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "createZip",
                "description": "Compresses a file or directory into an atomic ZIP archive with custom exclusion rules",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "deletePath",
                "description": "Previews or deletes a file or directory from the filesystem",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "detectFileType",
                "description": "Identifies a regular file from bounded content signatures with an optional libmagic refinement and an explicit extension comparison",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "downloadFile",
                "description": "Downloads a file from the Internet (similar to 'wget' or 'curl' in Unix)",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "extractZip",
                "description": "Extracts files from a ZIP archive after validating paths, types, limits, and destination conflicts",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "findBrokenSymlinks",
                "description": "Scans directories for broken symbolic links (pointing to nonexistent files or folders)",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "findDuplicateFiles",
                "description": "Scans a directory for identical files using size, SHA-256, and byte-for-byte verification",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "findFiles",
                "description": "Finds files by name, depth, size, and modification date with structured metadata",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "findText",
                "description": "Searches for text patterns in files with advanced filtering options",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getHumanLanguageStats",
                "description": "Analyzes files to estimate human-language distribution, with wildcard and recursive search support.",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "inspectImage",
                "description": "Inspects image dimensions, format, and size natively from headers (supports PNG, JPEG, GIF, BMP)",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "isDirectoryEmpty",
                "description": "Checks stable directory emptiness with streaming counts, explicit hidden-item policy, and no symbolic-link traversal by default",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "isFileBinary",
                "description": "Determines whether a regular file is binary or text using bounded start/middle/end content sampling",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "isFileEmpty",
                "description": "Checks zero-byte or whitespace-only file emptiness with streaming text decoding and no symbolic-link traversal by default",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "listFiles",
                "description": "Lists files in a directory with support for wildcards and recursive searching",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "movePath",
                "description": "Moves or renames one file, symbolic link, or complete directory; partial directory moves are rejected",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "readFile",
                "description": "Reads and displays the content of a file",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "repairWorkspace",
                "description": "Validates a saved auditWorkspace plan and applies only explicitly selected, unchanged cleanup actions",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "touchFile",
                "description": "Creates an empty file or updates the timestamp of an existing file",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            }
        ],
        "network": [
            {
                "name": "checkDns",
                "description": "Queries A, AAAA, MX, TXT, NS, and CNAME DNS records for a given domain",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "checkSslCertificate",
                "description": "Inspects certificate dates, hostname coverage, and trust-chain validation",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "checkUrlStatus",
                "description": "Requests an HTTP(S) URL and reports its status code, response time, and basic headers.",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "diagnoseWebsite",
                "description": "Diagnoses why an HTTPS website may be failing by correlating DNS, TLS certificate, and HTTP reachability evidence",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "getNetworkConfig",
                "description": "Displays comprehensive network status (interfaces, local IPs, DNS, public IP, VPN detection)",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            },
            {
                "name": "testInternetSpeed",
                "description": "Measures HTTP latency in milliseconds and bounded download throughput in Mbps and MiB/s",
                "maturity": {
                    "stage": "alpha",
                    "label": "Alpha",
                    "sequence": 2,
                    "public_executable": true,
                    "stability": "interface_may_change",
                    "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
                    "promotion_review_required": false,
                    "assessment_scope": "development_checkout"
                }
            }
        ]
    },
    "meta": {
        "command": "listCommands",
        "command_maturity": {
            "stage": "alpha",
            "label": "Alpha",
            "sequence": 2,
            "public_executable": true,
            "stability": "interface_may_change",
            "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
            "promotion_review_required": false,
            "assessment_scope": "development_checkout"
        },
        "duration_ms": 4.582,
        "schema_version": 1
    }
}

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message",
        "meta"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "meta": {
            "type": "object",
            "required": [
                "command",
                "command_maturity",
                "duration_ms",
                "schema_version"
            ],
            "properties": {
                "command": {
                    "type": "string"
                },
                "command_maturity": {
                    "type": "object",
                    "required": [
                        "stage",
                        "label",
                        "sequence",
                        "public_executable",
                        "stability",
                        "summary",
                        "promotion_review_required",
                        "assessment_scope"
                    ],
                    "properties": {
                        "stage": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        },
                        "sequence": {
                            "type": "integer"
                        },
                        "public_executable": {
                            "type": "boolean"
                        },
                        "stability": {
                            "type": "string"
                        },
                        "summary": {
                            "type": "string"
                        },
                        "promotion_review_required": {
                            "type": "boolean"
                        },
                        "assessment_scope": {
                            "type": "string"
                        },
                        "note": {
                            "type": "string"
                        },
                        "review": {
                            "type": "object",
                            "required": [
                                "reviewed_on",
                                "rationale",
                                "evidence"
                            ],
                            "properties": {
                                "reviewed_on": {
                                    "type": "string",
                                    "format": "date"
                                },
                                "rationale": {
                                    "type": "string"
                                },
                                "evidence": {
                                    "type": "array",
                                    "minItems": 1,
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "replacement": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": true
                },
                "duration_ms": {
                    "type": "number"
                },
                "schema_version": {
                    "type": "integer"
                }
            },
            "additionalProperties": true
        },
        "commands": [],
        "maturity_summary": [],
        "summary": []
    },
    "additionalProperties": true
}

Erros e limites

O contrato público exige success=false e uma message descritiva em caso de falha. Este catálogo ainda não declara uma taxonomia de erros específica para cada comando; revise o resultado e não infira códigos inexistentes.

O QZX está em alpha. Dependências opcionais, permissões e recursos do host podem alterar o resultado.

Fluxo de evidência: capturada e validada por digest.