Lewati ke konten utama

pengembangan · Referensi perintah

qzx getGitStatus

Apa fungsinya

Memberikan ringkasan terstruktur status Git: branch, remote, perubahan, dan commit terbaru.

Kematangan perintah: Alpha

Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.

Perilaku dan perlindungan bawaan

Memeriksa tanpa mengubah status

Eksekusi langsung untuk operasi ini

Menggunakan alat native saat diperlukan

Berfungsi tanpa menggunakan jaringan

Dirancang untuk bekerja tanpa elevasi hak akses

Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:96be8082239a867205cc1f4997a24a381e15557db9702280fc411c5528ff301b pada 2026-08-25.

Sintaks persis

qzx getGitStatus [repo_path] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

NamaTipeWajibDefaultDeskripsi
repo_pathstrTidak"."Jalur direktori yang akan dianalisis (default: direktori kerja saat ini)

Contoh input

qzx getGitStatus

Tampilkan status Git direktori saat ini

qzx getGitStatus C:/some/path

Tampilkan status Git repositori di C:/some/path

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx getGitStatus [repo_path] --json

Contoh output yang diamati

Ditangkap dengan QZX 0.2.2.0.9 di Windows 11; kode keluar 0. Nilai yang bergantung pada host dan durasi dapat bervariasi.

Perintah contoh: 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": 872.168,
        "schema_version": 1
    }
}
Lihat kontrak hasil 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
}

Kesalahan dan batasan

Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.

QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.

{
    "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": 8.048,
        "schema_version": 1
    }
}

Perintah yang ditangkap: qzx getGitStatus ../artifacts/qzx-evidence/git-status-missing --json

Alur bukti: ditangkap dan divalidasi dengan digest.

Bukti dan asal-usul

Kanal dokumentasi
Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Ketersediaan
0.2.2.0.9 atau lebih lama

Lanjut jelajahi

Perintah terkait

Perintah ini juga termasuk kategori pengembangan. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.

Jelajahi semua perintah QZX