Skip to content

v1.5.3 - CLI Interactive Menus & Documentation Completeness

Choose a tag to compare

View all tags
@greenarmor greenarmor released this 20 Jun 18:35
· 19 commits to master since this release
v1.5.3
321be88

Release v1.5.3 — CLI Interactive Menus & Documentation Completeness

Minor release. All parent commands (ges governance, ges policy, ges mcp, ges hooks) now show interactive guided menus instead of raw help text. Complete documentation for all 19 CLI commands including the new ges assign user guide. No breaking changes.

Previous release: v1.5.2
Release date: 2026-06-20

Highlights

Interactive Guided Menus — Never Get Stuck

Running ges governance, ges policy, ges mcp, or ges hooks without a subcommand previously dumped raw help text and exited. Users had no idea what to do next.

Now you get a guided menu:

$ ges governance

  GESF Governance
  Provenance Chain Management

  Existing Records (1)

  ● APPROVED Payment Processing API
     ID     gov-1781934540528-1
     Type   api  |  Risk HIGH

? What would you like to do?
❯ Create a new governance record — start a new approval chain
  List all records (1 existing)
  Show a record's full provenance chain
  Verify a record's completeness
  Record an approval decision
  Add an evidence reference
  Exit — return to terminal

Every menu has:

  • Descriptions for each option (so users know what each does)
  • Exit option (always available, never trapped)
  • Context-aware choices (governance menu shows existing records, policy shows installed packs, hooks detects install state)
  • Smart selection (when only 1 governance record exists, it's auto-selected)

CI/CD safe — in non-TTY mode, falls back to help text and exits 0. Never hangs.

Prompt Hints — No More Guessing

Every interactive prompt now shows examples and format guidance:

Before After
Risk score: Risk score (e.g., '7.5/10', 'High'):
Methodology: Methodology (e.g., 'NIST RMF', 'ISO 27005'):
Approver name: Approver full name:
Valid until (YYYY-MM-DD): Valid until YYYY-MM-DD (or press Enter for indefinite):

30+ prompts updated across governance and assign commands.

What's New

CLI Improvements

Command Change
ges governance Interactive parent menu — 13 actions with descriptions, shows existing records, auto-selects when 1 record
ges policy Interactive parent menu — shows installed packs, pack picker for install/remove
ges mcp Interactive parent menu — setup/start with descriptions
ges hooks Interactive parent menu — detects install state, context-aware install/uninstall
ges assign Prompt hints and defaults for all fields

Documentation

All 19 CLI commands now fully documented with complete flag tables:

Documentation Change Details
New: ges assign Full command reference with all 13 flags, assign/list/resolve examples
Fixed: ges init Added --country and --force flags
Fixed: ges audit Added --incremental flag
Expanded: ges governance All 13 subcommands now have dedicated sections with complete flag tables
New user guide docs/user-guide/fix-assignments.md — 400+ lines with workflow, data storage, dashboard/MCP integration, and 5 hands-on exercises

New User Guide: Fix Assignments

Comprehensive guide for linking audit findings to governance provenance records:

  • Prerequisites and workflow (audit → governance → assign → resolve)
  • Finding keys explanation (ruleId:file:line format)
  • Data storage — .ges/fix-assignments.json structure
  • Dashboard integration — inline provenance chain display
  • MCP integration — 3 tools table
  • 5 exercises: Assign first fix, Build provenance chain, Resolve and track, Dashboard view, Multi-finding assignment

Verification

  • Full E2E test: All 19 CLI commands tested end-to-end in a fresh project — init → audit → fix → assign → governance (full lifecycle) → generate → report → badge → scan → doctor → validate → policy → control → hooks → dashboard → mcp
  • 8 edge cases: Non-TTY mode (4 parent commands), missing .ges/, missing audit data, missing args
  • Zero failures, zero hangs
  • 483 tests passing, all 16 packages build clean

Changed Files

docs/reference/commands.md              | 240 +++++++++++++++++++++++++++++++--
docs/user-guide/fix-assignments.md      | 400+ lines (new)
mkdocs.yml                              |   1 +
packages/cli/src/commands/assign.ts     |  12 +-
packages/cli/src/commands/governance.ts | 155 ++++++++++++++++-----
packages/cli/src/commands/hooks.ts      |  49 +++++++
packages/cli/src/commands/mcp.ts        |  32 +++++
packages/cli/src/commands/policy.ts     |  85 ++++++++++-

7 files changed, 520 insertions(+), 54 deletions(-)

Upgrade

npm update -g @greenarmor/ges
# or
pnpm update -g @greenarmor/ges

Existing projects continue to work unchanged. No migration needed.

Assets 2
Loading