Update README for clarity, consistency, and completeness

Revised command examples for consistency, clarified prerequisites and installation steps, expanded and standardized command documentation, refined project structure and build instructions, and improved contributing guidelines. Made minor formatting and language improvements throughout.

#16

Author: ziagham

README.md

@@ -12,8 +12,6 @@
 
 </div>
 
----
-
 ## Table of Contents
 
 - [Overview](#overview)
@@ -37,8 +35,6 @@
 - [Contributing](#contributing)
 - [License](#license)
 
----
-
 ## Overview
 
 Vectra is an **Intent-Aware Governance Gateway** that sits between autonomous AI agents and the outside world. It enforces governance policies, routes actions through Human-in-the-Loop review when required, and provides a full audit trail.
@@ -52,8 +48,6 @@ AI Agent  ──►  Vectra Gateway  ──►  External Systems
           (manage, audit, approve)
 ```
 
----
-
 ## Prerequisites
 
 | Requirement | Minimum Version |
@@ -63,8 +57,6 @@ AI Agent  ──►  Vectra Gateway  ──►  External Systems
 
 Docker is only required when using the `--docker` deployment mode.
 
----
-
 ## Installation
 
 ### Option 1 – Download a pre-built binary (recommended)
@@ -86,8 +78,6 @@ dotnet publish src/VectraCtl/VectraCtl.csproj -c Release -o ./publish
 # Add ./publish to your PATH
 ```
 
----
-
 ## Quick Start
 
 ```bash
@@ -113,8 +103,6 @@ vectractl hitl list
 vectractl hitl approve --id <REQUEST-ID> --comment "Reviewed and approved"
 ```
 
----
-
 ## Commands
 
 ### `init`
@@ -147,8 +135,6 @@ vectractl init --version 1.5.0
 vectractl init --docker --port 7080 --mount ~/vectra-data
 ```
 
----
-
 ### `run`
 
 Starts the Vectra gateway (binary or Docker container).
@@ -171,8 +157,6 @@ vectractl run --docker               # start Docker container (foreground)
 vectractl run --docker --background  # start Docker container (detached)
 ```
 
----
-
 ### `stop`
 
 Stops the running Vectra gateway.
@@ -190,8 +174,6 @@ vectractl stop
 vectractl stop --docker
 ```
 
----
-
 ### `update`
 
 Updates the Vectra gateway binary to a newer (or specific) version.
@@ -211,8 +193,6 @@ vectractl update --version 2.0.0   # update to a specific version
 vectractl update --force            # stop gateway automatically, then update
 ```
 
----
-
 ### `uninstall`
 
 Removes the Vectra gateway engine (binary or Docker).
@@ -233,8 +213,6 @@ vectractl uninstall --docker --remove-data
 vectractl uninstall --force
 ```
 
----
-
 ### `agents`
 
 Manage AI agents registered in the Vectra gateway.
@@ -274,8 +252,6 @@ vectractl agents assign-policy --agent-id <GUID> --policy <policy-name>
 vectractl agents delete --agent-id <GUID>
 ```
 
----
-
 ### `policies`
 
 Browse governance policies defined in the Vectra gateway.
@@ -292,8 +268,6 @@ vectractl policies list [--page <n>] [--page-size <n>] [-o json|table]
 vectractl policies details --name <policy-name> [-o json|table]
 ```
 
----
-
 ### `hitl`
 
 Manage Human-in-the-Loop review requests generated by the gateway when an agent action requires human approval.
@@ -322,8 +296,6 @@ vectractl hitl approve --id <request-id> [--comment "Approved"]
 vectractl hitl deny --id <request-id> [--comment "Rejected: policy violation"]
 ```
 
----
-
 ### `token`
 
 Exchange agent credentials for a short-lived JWT bearer token that can be used to authenticate API calls to the Vectra gateway.
@@ -342,8 +314,6 @@ vectractl token --agent-id <GUID> --secret <secret> [-o json|table]
 vectractl token --agent-id 3fa85f64-5717-4562-b3fc-2c963f66afa6 --secret "s3cr3t"
 ```
 
----
-
 ## Global Options
 
 These options are available on all list-style subcommands:
@@ -354,8 +324,6 @@ These options are available on all list-style subcommands:
 | `--page-size <n>` | Number of results per page | `25` |
 | `-o, --output` | Output format: `json` or `table` | `json` |
 
----
-
 ## Configuration
 
 `vectractl` stores its runtime configuration in `~/.vectra/appsettings.json`. This file is created automatically when you run `vectractl init` and is updated by subsequent commands.
@@ -379,8 +347,6 @@ These options are available on all list-style subcommands:
 
 You can edit this file manually or use `vectractl init` to regenerate it.
 
----
-
 ## Project Structure
 
 ```
@@ -403,8 +369,6 @@ vectractl/
 └── README.md
 ```
 
----
-
 ## Building from Source
 
 ```bash
@@ -427,8 +391,6 @@ dotnet test
 
 Supported runtime identifiers: `win-x64`, `linux-x64`, `osx-x64`, `osx-arm64`.
 
----
-
 ## Contributing
 
 Contributions are welcome! Please follow these steps:
@@ -440,8 +402,6 @@ Contributions are welcome! Please follow these steps:
 
 Please keep PRs focused on a single concern. For large changes, open an issue first to discuss the approach.
 
----
-
 ## License
 
 © Cortexium Labs. Licensed under the [Apache License, Version 2.0](LICENSE).