archivos · Referencia de comando
qzx auditWorkspace
Qué hace
Crea un plan determinista con huellas de contenido para revisar posibles limpiezas sin alterar el workspace.
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.9. La documentación corresponde al checkout alpha 0.2.2.0.9.
Comportamiento y protecciones integradas
El modo real aplica los cambios que solicites
Ejecución directa para esta operación
Funciona sin invocar programas nativos
Funciona sin usar la red
Diseñado para funcionar sin elevación
La auditoría nunca modifica el contenido del workspace. De forma predeterminada es completamente de solo lectura; plan_file puede crear explícitamente un único plan JSON direccionado por contenido y nunca sobrescribe un archivo existente. Los artefactos, logs, respaldos, patrones de nombres, enlaces, entradas especiales y sugerencias de reorganización permanecen únicamente para revisión.
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Sol contra el digest de implementación sha256:c9c12a87a4e34c402974dda6d9cdbe06600092b5fa10f36ff9936a05e4aca237 el 2026-09-05.
Sintaxis exacta
qzx auditWorkspace [path] [categories] [max_files] [plan_file] --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 que se auditará |
| categories | str | No | "build,temp,artifacts,duplicates,reorganizations" | Categorías separadas por comas: build, temp, artifacts, duplicates y reorganizations |
| max_files | int | No | 15000 | Cantidad máxima de entradas que no sean directorios que se inspeccionarán |
| plan_file | str | No | No declarado | Archivo JSON nuevo y opcional en el que se guardará el plan; nunca se sobrescriben archivos existentes |
Ejemplos de entrada
qzx auditWorkspace .Inspeccionar el workspace actual sin escribir ningún archivo
qzx auditWorkspace . --categories build,temp,duplicates --plan-file qzx-repair-plan.jsonGuardar un plan de build, temporales y duplicados que repairWorkspace pueda validar posteriormente
Para obtener la carga estructurada completa, añade --json: qzx auditWorkspace [path] [categories] [max_files] [plan_file] --json
Ejemplo de salida observada
Capturado con QZX 0.2.2.0.9 en Windows 11; código de salida 0. Los valores dependientes del host y la duración pueden variar.
Comando del ejemplo: qzx auditWorkspace ../artifacts/qzx-evidence/repair-workspace/workspace --plan-file ../artifacts/qzx-evidence/repair-workspace/plan.json --json
{
"success": true,
"status": "complete",
"message": "Workspace audit complete: 1 executable cleanup action(s) and 0 review-only finding(s), totaling 28 recoverable byte(s). Plan saved to 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\repair-workspace\\plan.json'.",
"details": {
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\repair-workspace\\workspace",
"workspace_unchanged": true,
"plan_file": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\repair-workspace\\plan.json",
"plan": {
"schema_version": 1,
"root": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\repair-workspace\\workspace",
"categories": [
"build",
"temp",
"artifacts",
"duplicates",
"reorganizations"
],
"max_files": 15000,
"scan_complete": true,
"scanned_files": 1,
"scanned_directories": 0,
"ignored_paths": [],
"scan_errors": [],
"actions": [
{
"category": "temp",
"kind": "delete_file",
"path": "debug.tmp",
"reason": "Temporary editor or tool output selected for explicit cleanup.",
"executable": true,
"size_bytes": 28,
"fingerprint": {
"type": "file",
"size_bytes": 28,
"sha256": "a4be5b5eeff332365000a7d71223443e63df5d51a58fdb60aa682b8b01d22266"
},
"id": "act-76685ad35f1fd085e962"
}
],
"summary": {
"total_actions": 1,
"executable_actions": 1,
"review_only_actions": 0,
"recoverable_bytes": 28,
"category_counts": {
"build": 0,
"temp": 1,
"artifacts": 0,
"duplicates": 0,
"reorganizations": 0
}
},
"plan_id": "plan-70b0f1e9ef689794bc9423b4e17812fad340a3316bb5ddf912c29483aa6d05b5"
}
},
"meta": {
"command": "auditWorkspace",
"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": 31.418,
"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
},
"details": {
"oneOf": [
{
"type": "object",
"properties": {
"path": [],
"workspace_unchanged": {
"type": "boolean"
},
"plan_file": [],
"plan": []
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"path": []
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"path": [],
"plan": [],
"plan_file": []
},
"additionalProperties": true
}
]
},
"error": [],
"error_code": {
"type": "string"
},
"status": {
"type": "string"
}
},
"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.
Flujo de evidencia: capturada y validada por digest.
Evidencia y procedencia
- Implementación
- src/qzx/commands/file/audit_workspace.py
- Pruebas
- No se encontró un archivo de prueba específico con el mismo nombre de módulo; esto no demuestra ausencia total de cobertura.
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Disponibilidad
- 0.2.2.0.9 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 touchFileCrea un archivo vacío o actualiza la marca de tiempo de uno existente.qzx calculateFileHashCalcula hashes criptográficos MD5, SHA-1 y SHA-256 de un archivo.qzx repairWorkspaceValida un plan guardado de auditWorkspace y aplica únicamente las acciones de limpieza seleccionadas que no hayan cambiado.qzx changePermissionsCambia los permisos de un archivo o directorio.