archivos · Referencia de comando
qzx repairWorkspace
Qué hace
Valida un plan guardado de auditWorkspace y aplica únicamente las acciones de limpieza seleccionadas que no hayan cambiado.
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
El modo real aplica los cambios que solicites
Vista previa disponible
Funciona sin invocar programas nativos
Funciona sin usar la red
Usa tus permisos actuales; el resultado puede variar
La previsualización es el comportamiento predeterminado. Una reparación real exige un plan completo guardado por auditWorkspace, identificadores explícitos de acciones ejecutables, huellas de contenido sin cambios, dry_run=false, apply=true y un respaldo del workspace con protección ante fallos. Las entradas seleccionadas se aíslan en staging dentro del mismo workspace antes de limpiarlas; los hallazgos de solo revisión nunca pueden aplicarse.
QZX crea un archivo de recuperación antes de los cambios reales; usa --dangerously-bypass-approvals-and-sandbox/--yolo solo cuando decidas omitirlo deliberadamente.
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Sol contra el digest de implementación sha256:dd5295cd267097ab0e54e7cb7e02105099db87446652192be1d31fad5da527e5 el 2026-09-05.
Sintaxis exacta
qzx repairWorkspace [path] [plan_file] [action_ids] [dry_run] [apply] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| path | str | No | "." | Directorio del workspace al que corresponde el plan guardado |
| plan_file | str | No | No declarado | Plan JSON creado por auditWorkspace |
| action_ids | str | No | No declarado | Identificadores separados por comas de las acciones ejecutables que revisó el operador |
| dry_run | bool | No | true | Valida y previsualiza sin cambiar el workspace |
| apply | bool | No | false | Autoriza explícitamente las acciones seleccionadas; requiere dry_run=false |
Ejemplos de entrada
qzx repairWorkspace . --plan-file qzx-repair-plan.jsonValidar el plan guardado y enumerar sus acciones ejecutables
qzx repairWorkspace . --plan-file qzx-repair-plan.json --action-ids act-123,act-456 --dry-run false --applyRespaldar el workspace, volver a validar dos acciones y aplicarlas
Para obtener la carga estructurada completa, añade --json: qzx repairWorkspace [path] [plan_file] [action_ids] [dry_run] [apply] --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 repairWorkspace ../artifacts/qzx-evidence/repair-workspace/workspace --plan-file ../artifacts/qzx-evidence/repair-workspace/plan.json --json
{
"success": true,
"status": "preview",
"message": "Repair plan 'plan-70b0f1e9ef689794bc9423b4e17812fad340a3316bb5ddf912c29483aa6d05b5' is valid and unchanged. 1 executable action(s) are available; 0 selected. Nothing was changed.",
"details": {
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\repair-workspace\\workspace",
"plan_file": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\repair-workspace\\plan.json",
"plan_id": "plan-70b0f1e9ef689794bc9423b4e17812fad340a3316bb5ddf912c29483aa6d05b5",
"dry_run_mode": true,
"apply_requested": false,
"workspace_unchanged": true,
"selected_actions": [],
"executable_actions": [
{
"category": "temp",
"executable": true,
"fingerprint": {
"sha256": "a4be5b5eeff332365000a7d71223443e63df5d51a58fdb60aa682b8b01d22266",
"size_bytes": 28,
"type": "file"
},
"id": "act-76685ad35f1fd085e962",
"kind": "delete_file",
"path": "debug.tmp",
"reason": "Temporary editor or tool output selected for explicit cleanup.",
"size_bytes": 28
}
],
"review_only_actions": []
},
"meta": {
"command": "repairWorkspace",
"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": 7.474,
"schema_version": 1
}
}Ver el contrato de resultado JSON
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"preview",
"applied",
"rolled_back",
"recovery_required",
"cleanup_incomplete"
]
},
"error_code": {
"type": "string"
},
"error": {
"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: capturada y validada por digest.
Evidencia y procedencia
- Implementación
- src/qzx/commands/file/repair_workspace.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 archivos. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx readFileLee y muestra el contenido de un archivo.qzx touchFileCrea un archivo vacío o actualiza la marca de tiempo de uno existente.qzx movePathMueve o renombra un archivo, enlace simbólico o directorio completo; rechaza movimientos parciales de directorios.qzx auditWorkspaceCrea un plan determinista con huellas de contenido para revisar posibles limpiezas sin alterar el workspace.