desarrollo · Referencia de comando

`qzx planProjectBootstrap`

Qué hace

Construye un plan seleccionable para iniciar un proyecto sin escribir archivos, instalar dependencias, crear secretos ni ejecutar migraciones.

Comando canónico: planProjectBootstrap

Alias aceptados: Ninguno

Distingue mayúsculas: no

Madurez del comando: Alpha

Disponible para uso real y retroalimentación mientras su interfaz y comportamiento todavía pueden evolucionar. Esta es la evaluación actual del checkout de desarrollo. Cada futuro tag inmutable de release conservará la evaluación exacta incluida en esa versión. Disponible en PyPI 0.2.2.0.6a8. La documentación corresponde al checkout alpha 0.2.2.0.6a8.

Seguridad y efectos

Solo lectura según la clasificación actual

Sin parámetro dry-run documentado

No invoca programas nativos según la clasificación

Sin uso de red documentado

No requiere elevación de forma inherente

Es estrictamente de solo lectura: no crea directorios, ejecuta herramientas, accede a la red, instala paquetes, genera secretos, configura hooks ni lanza migraciones o pruebas. Cada paso declara si podría usar red, manejar datos sensibles, modificar archivos o alterar estado externo. Si no detecta exactamente un stack exige --tech en vez de asumir Python.

Esta clasificación de seguridad fue revisada por Codex contra el digest de implementación sha256:6f8a9c455d3c163fe5887f84f1e963bef7b6df267cf1496ee3efc0af017078af el 2026-07-30.

Sintaxis exacta

qzx planProjectBootstrap [path] [tech] [components] --json

Parámetros

Desliza o usa la barra horizontal para ver todas las columnas.

Nombre	Tipo	Obligatorio	Predeterminado	Descripción
path	str	No	"."	Directorio del proyecto que se inspeccionará o planificará
tech	str	No	No declarado	Stack explícito: python, node, typescript, rust, php o cpp. Es obligatorio si los manifiestos no identifican exactamente un stack
components	str	No	"all"	Secciones del plan separadas por comas: structure, environment, dependencies, configuration, hooks, database, checks o all

Ejemplos de entrada

qzx planProjectBootstrap . --tech python

Planificar todos los componentes de un proyecto Python sin escribir archivos

qzx planProjectBootstrap ./web --tech typescript --components structure,dependencies,checks

Planificar componentes seleccionados de un proyecto TypeScript

qzx planProjectBootstrap ./existing-project

Detectar un único stack inequívoco mediante los manifiestos existentes

Para obtener la carga estructurada completa, añade --json: qzx planProjectBootstrap [path] [tech] [components] --json

Ejemplo de salida representativa

Este JSON ilustrativo deriva del contrato de resultado respaldado por la implementación actual. Muestra lo que el comando puede devolver sin afirmar que es una ejecución grabada; los valores varían según entradas, equipo, permisos y herramientas opcionales.

Comando del ejemplo: qzx planProjectBootstrap . --tech python --json

{
    "success": true,
    "message": "Builds a selectable project bootstrap plan without writing files, installing dependencies, creating secrets, or running migrations. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "planProjectBootstrap",
        "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": 0,
        "schema_version": 1
    },
    "details": {
        "summary": "Additional structured context is included here."
    }
}

Ver el contrato de resultado JSON

{
    "type": "object",
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "details": {
            "type": "object",
            "additionalProperties": true
        },
        "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
        }
    },
    "additionalProperties": true,
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "message",
        "meta",
        "success"
    ]
}

Errores y límites

El contrato público exige success=false y un message descriptivo en fallos. Este catálogo aún no declara una taxonomía de errores específica para cada comando; revisa el resultado y no infieras códigos inexistentes.

QZX está en alpha. Dependencias opcionales, permisos y capacidades del host pueden cambiar el resultado.

Flujo de evidencia: lista para captura automática determinista.

Evidencia y procedencia

Implementación: src/qzx/commands/development/plan_project_bootstrap.py
Pruebas: tests/test_development_commands/test_plan_project_bootstrap.py
Canal de documentación: Documentación de desarrollo 0.2.2.0.6a8 · main · sha256:040df8bbcb6b707bb4cdb7c2c1ad4cc6956ab647a451dc215ea78cdbb4c8ad96
Disponibilidad: 0.2.2.0.6a8 o anterior

Sigue explorando

Estos comandos también pertenecen a la categoría de desarrollo. Compáralos para elegir la operación que mejor resuelva tu tarea.

Explorar todos los comandos de QZX