desarrollo · Referencia de comando
qzx getGitStatus
Qué hace
Proporciona un resumen estructurado del estado de Git: rama, remoto, cambios y commits recientes.
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.8. La documentación corresponde al checkout alpha 0.2.2.0.8.
Comportamiento y protecciones integradas
Inspecciona sin cambiar el estado
Ejecución directa para esta operación
Usa una herramienta nativa cuando hace falta
Funciona sin usar la red
Diseñado para funcionar sin elevación
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Pro contra el digest de implementación sha256:96be8082239a867205cc1f4997a24a381e15557db9702280fc411c5528ff301b el 2026-08-25.
Sintaxis exacta
qzx getGitStatus [repo_path] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| repo_path | str | No | "." | Ruta del directorio que se analizará (valor predeterminado: directorio de trabajo actual) |
Ejemplos de entrada
qzx getGitStatusMostrar el estado de Git del directorio actual
qzx getGitStatus C:/some/pathMostrar el estado de Git del repositorio ubicado en C:/some/path
Para obtener la carga estructurada completa, añade --json: qzx getGitStatus [repo_path] --json
Ejemplo de salida observada
Capturado con QZX 0.2.2.0.8 en Windows 11; código de salida 0. Los valores dependientes del host y la duración pueden variar.
Comando del ejemplo: qzx getGitStatus ../artifacts/qzx-evidence/git-status --json
{
"success": true,
"is_git_repository": true,
"repo_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\git-status",
"branch": "main",
"tracking_branch": null,
"sync_status": {
"ahead": 0,
"behind": 0,
"in_sync": true
},
"changes": {
"staged": [
"staged.txt"
],
"modified": [
"tracked.txt"
],
"untracked": [
"untracked.txt"
],
"deleted": [],
"renamed": []
},
"changes_summary": {
"staged_count": 1,
"modified_count": 1,
"untracked_count": 1,
"deleted_count": 0,
"total_changes": 3
},
"remotes": {
"origin": {
"fetch": "https://example.invalid/qzx-evidence.git",
"push": "https://example.invalid/qzx-evidence.git"
}
},
"recent_commits": [
{
"hash": "cf86262",
"author": "QZX Evidence Fixture",
"date": "2026-08-08",
"subject": "Create controlled QZX evidence fixture"
}
],
"message": "Git Repository Status for 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\git-status':\n- Branch: main\n- Tracking: None\n- Uncommitted Changes: Staged=1, Modified=1, Untracked=1, Deleted=0\n- Latest Commit: [cf86262] Create controlled QZX evidence fixture by QZX Evidence Fixture (2026-08-08)",
"meta": {
"command": "getGitStatus",
"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": 1262.381,
"schema_version": 1
}
}Ver el contrato de resultado JSON
{
"$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
},
"branch": [],
"changes": {
"type": "object",
"properties": {
"staged": [],
"modified": [],
"untracked": [],
"deleted": [],
"renamed": []
},
"additionalProperties": true
},
"changes_summary": {
"type": "object",
"properties": {
"staged_count": [],
"modified_count": [],
"untracked_count": [],
"deleted_count": [],
"total_changes": []
},
"additionalProperties": true
},
"error": {
"type": "string"
},
"is_git_repository": {
"type": "boolean"
},
"recent_commits": [],
"remotes": [],
"repo_path": [],
"sync_status": {
"type": "object",
"properties": {
"ahead": [],
"behind": [],
"in_sync": {
"type": "boolean"
}
},
"additionalProperties": true
},
"tracking_branch": []
},
"additionalProperties": true
}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.
{
"success": false,
"error": "Path '../artifacts/qzx-evidence/git-status-missing' does not exist.",
"message": "Path '../artifacts/qzx-evidence/git-status-missing' does not exist.",
"meta": {
"command": "getGitStatus",
"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": 3.312,
"schema_version": 1
}
}Comando capturado: qzx getGitStatus ../artifacts/qzx-evidence/git-status-missing --json
Flujo de evidencia: capturada y validada por digest.
Evidencia y procedencia
- Implementación
- src/qzx/commands/development/get_git_status.py
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
- Disponibilidad
- 0.2.2.0.8 o anterior
Sigue explorando
Comandos relacionados
Estos comandos también pertenecen a la categoría de desarrollo. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx formatCodeDetecta el lenguaje y ejecuta el formateador correspondiente sobre archivos de código fuente.qzx getProjectTreeGenera un árbol acotado en ASCII y JSON sin seguir enlaces simbólicos descendientes.qzx findUnusedCodeBusca funciones, clases y exportaciones sin referencias visibles para revisarlas antes de retirarlas.qzx planProjectBootstrapConstruye un plan seleccionable para iniciar un proyecto sin escribir archivos, instalar dependencias, crear secretos ni ejecutar migraciones.