feat(cli): v0.26.0 DQS Workspace UI and JSON output - #186
Merged
Conversation
…T-002)
Adds a --json flag to `zenzic score` as an ergonomic shorthand for
--format json. When passed, it overrides the output format to JSON before
any rendering logic runs, suppressing all rich/text output and emitting a
single deterministic JSON object on stdout.
Intended for programmatic consumers (e.g., editor integrations) that need
to parse the score without grepping through rich terminal output. The flag
is functionally identical to `--format json` / `-f json` — same code path,
same ScoreReport.to_dict() schema, same exit code contract.
Schema emitted on stdout:
{"project": "zenzic", "score": 98, "status": "success",
"categories": [...], "suppression_debt_pts": 2, ...}
Architectural invariants preserved:
- Radical Unawareness (ADR-075): Core emits JSON to stdout, unaware of consumer.
- Zero Subprocess: no child processes spawned by Core.
Part of: ECOSYSTEM-FEAT-002-DQS-WORKSPACE-UI (v0.26.0 Deterministic Quality Platform)
Signed-off-by: PythonWoods <gianluca.catalano@gmail.com>
Per la Mirror Law (ADR-020), i runbook e la documentazione devono riflettere esattamente le procedure e le flag CLI reali. Aggiornamenti a docs/reference/cli.md — tab 'zenzic score': - Aggiunta riga --json alla tabella dei flag: shorthand for --format json, per consumer programmatici (editor integration, shell scripts). - Documentati i flag precedentemente mancanti: --breakdown, --save, --check-stamp, --no-header, --ci (completamento della tabella). - Aggiunto esempio 'zenzic score --json' nel blocco di usage examples. - Aggiunta sezione collassabile 'JSON Output Schema (--json)' con lo schema completo di ScoreReport.to_dict() e i valori possibili di 'status'. Verificato con: just docs-build (mkdocs build --strict, 0 errori). Part of: ECOSYSTEM-FEAT-002-DQS-WORKSPACE-UI (v0.26.0 Deterministic Quality Platform) Signed-off-by: PythonWoods <gianluca.catalano@gmail.com>
…(ROADMAP-ALIGN-004) Realigns public ROADMAP.md and internal 0. Priority Table.md: - Promotes DQS Workspace UI to [v0.26] milestone. - Shifts Deterministic Quality Platform to [v0.27]. - Shifts Governance & Extensibility to [v0.28]. - Shifts Ecosystem Expansion to [v0.29]. - Shifts Operational Excellence to [v0.30]. - Marks Prompt 8 (DQS Workspace UI) as [x] Completata (v0.26.0). Verifications: - zenzic check all --strict: DQS 98/100 (Passed) - just docs-build: 0 errors (Passed) Architectural invariants preserved: Mirror Law (ADR-020). Part of: ROADMAP-ALIGN-004-V026-SHIFT Signed-off-by: PythonWoods <gianluca.catalano@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Objective
Deploy minor release
0.26.0to introduce the DQS Workspace UI foundation, enabling asynchronous, deterministic score computation for IDE integrations.Architectural Changes
ECOSYSTEM-FEAT-002): Added the--jsonalias to thezenzic scorecommand. This suppresses all rich text output and emits a clean JSON object (ScoreReport.to_dict()) tostdout, facilitating programmatic consumption by thin clients (e.g., VS Code) while preserving the Radical Unawareness invariant (ADR-075).DOCS-IA-020): Updatedcli.mdto document the new flag and the complete JSON output schema.ROADMAP-ALIGN-004): UpdatedROADMAP.mdto reflect the0.26.0milestone shift.Verification
uv run zenzic check all --strictpassed (DQS 98/100).pytestsuite passed (1484/1484).