development · Command reference

qzx scanProject

What it does

Scans a project root to identify technologies, scripts, configuration files, and missing environment keys

Canonical command: scanProject

Accepted aliases: None

Case-sensitive: no

Included in the published package

Available in PyPI 0.2.2.0.2. This page documents the 0.2.2.0.2 alpha development checkout.

Safety and effects

Read-only under the current classification

No documented dry-run parameter

No native program invocation in the current classification

No documented network use

No inherent elevation requirement

This safety classification was reviewed against implementation digest sha256:f48e9d0cf956983d31462e511d40d4175a994ba6791e4959cca39d1b36276e97 on 2026-07-24.

Exact syntax

qzx scanProject [project_path] --json

Parameters

NameTypeRequiredDefaultDescription
project_pathstrNo"."Path to the project root directory (defaults to current directory)

Input examples

qzx scanProject

Scan the current workspace directory

qzx scanProject C:/my-projects/app

Scan the project located at C:/my-projects/app

For the complete structured payload, add --json: qzx scanProject [project_path] --json

Representative output example

This illustrative JSON is derived from the current implementation-backed result contract. It shows what the command can return without claiming a recorded execution; values vary with inputs, host, permissions, and optional tools.

Example command: qzx scanProject --json

{
    "success": true,
    "message": "Scans a project root to identify technologies, scripts, configuration files, and missing environment keys. In this illustrative example, the command completed successfully.",
    "configuration_files": [
        "pyproject.toml",
        "package.json"
    ],
    "environment_diagnostics": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "package_json": "Example value",
    "package_managers": [
        "pnpm",
        "pip"
    ],
    "php_dependencies": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "project_path": "C:\\project\\example.txt",
    "project_types": [
        "Python",
        "Node.js"
    ],
    "python_dependencies": [
        "psutil",
        "PyYAML"
    ]
}
View the JSON result contract
{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "configuration_files": [],
        "environment_diagnostics": [],
        "error": {
            "type": "string"
        },
        "package_json": [],
        "package_managers": [],
        "php_dependencies": [],
        "project_path": [],
        "project_types": [],
        "python_dependencies": []
    },
    "additionalProperties": true
}

Errors and limits

The public contract requires success=false and a descriptive message on failure. This catalog does not yet declare a command-specific error taxonomy; inspect the result and do not invent error codes.

QZX is alpha software. Optional dependencies, permissions, and host capabilities can change the result.

Evidence workflow: ready for deterministic automated capture.

Evidence and provenance

Documentation channel
Development documentation 0.2.2.0.2 · main · sha256:319b16857a87636ebc3b89734cc040a737bb56194464fca33ce73bdae2043096
Availability
0.2.2.0.2 or earlier

Keep exploring

These commands also belong to the development category. Compare them to choose the operation that best fits your task.

Explore all QZX commands