updatations

Author: voltsparx

README.md

@@ -27,6 +27,7 @@ Project website: [https://voltsparx.github.io/ASRFacet-Rb/](https://voltsparx.gi
 - [Installation Guide](#installation-guide)
 - [Usage Guide with Examples](#usage-guide-with-examples)
 - [Output, Storage, and Reporting](#output-storage-and-reporting)
+- [Transparency and Operator Expectations](#transparency-and-operator-expectations)
 - [Testing and Release Verification](#testing-and-release-verification)
 - [Troubleshooting Guide](#troubleshooting-guide)
 - [Documentation Map](#documentation-map)
@@ -131,6 +132,7 @@ Installer prompt theme:
 | `dns DOMAIN` | DNS-focused collection | `asrfacet-rb dns example.com` |
 | `--console` | Interactive shell mode | `asrfacet-rb --console` |
 | `--web-session` | Local web control panel | `asrfacet-rb --web-session` |
+| `--version` | Print installed version | `asrfacet-rb --version` |
 | `about` | Framework overview | `asrfacet-rb about` |
 | `--explain TOPIC` | Built-in topic guidance | `asrfacet-rb --explain scope` |
 
@@ -190,6 +192,25 @@ flowchart TD
     E --> F[Change Summary Available]
 ```
 
+## Transparency and Operator Expectations
+
+ASRFacet-Rb is meant to be inspectable and explicit about what it is doing.
+
+- Active modes make real DNS, TCP, HTTP, and related network requests to the configured target scope.
+- Passive results come from external sources and may be incomplete, stale, or include shared infrastructure that is not automatically authorized.
+- The local web session starts a local HTTP server and stores persistent drafts under `~/.asrfacet_rb/web_sessions/`.
+- Report bundles, event streams, and recon memory are written under `~/.asrfacet_rb/output/` and `~/.asrfacet_rb/memory/`.
+- Findings and prioritization are operator aids, not proof of exploitability or ownership.
+- The framework does not claim stealth, evasion, or guaranteed completeness.
+- Scope control remains the operator's responsibility. Use `--scope` and `--exclude` before active runs.
+
+Manual surfaces:
+
+- `asrfacet-rb manual`
+- `asrfacet-rb manual workflow`
+- `man asrfacet-rb`
+- `man asrfrb`
+
 ## Testing and Release Verification
 
 ```bash

docs/getting-started.md

@@ -11,7 +11,7 @@
 ```bash
 bundle install
 bundle exec ruby bin/asrfacet-rb help
-bundle exec ruby bin/asrfacet-rb version
+bundle exec ruby bin/asrfacet-rb --version
 bundle exec ruby bin/asrfacet-rb about
 bundle exec ruby bin/asrfacet-rb --explain scope
 bundle exec rake
@@ -100,6 +100,14 @@ The pipeline may also write a JSONL event stream under:
 ~/.asrfacet_rb/output/streams/
 ```
 
+## Transparency
+
+- Active commands send real requests to the targets you specify.
+- Passive results can still include third-party or stale infrastructure, so treat them as leads to validate, not automatic in-scope truth.
+- The web session starts a local server on `127.0.0.1:4567` by default and stores drafts under `~/.asrfacet_rb/web_sessions/`.
+- Recon memory and report bundles persist under `~/.asrfacet_rb/memory/` and `~/.asrfacet_rb/output/`.
+- Findings help prioritize operator review, but they are not guaranteed exploit proof.
+
 ## Built-In Help
 
 ```bash
@@ -108,4 +116,6 @@ asrfacet-rb help scan
 asrfacet-rb explain scope
 asrfacet-rb manual
 asrfacet-rb manual workflow
+man asrfacet-rb
+man asrfrb
 ```

docs/web-session.md

@@ -20,6 +20,25 @@ The web control panel is local-only by default and binds to `127.0.0.1:4567` unl
 - review an about section with framework and storage details
 - persist drafts across browser closes and host interruptions
 
+## Layout Model
+
+The current shell is organized more like a control plane than a single long page:
+
+- a persistent left rail for workspace navigation and saved sessions
+- a session builder with tabs for targeting, execution, and integrations
+- a workbench for summary cards, exposure tables, and snapshot views
+- a reports view for stored artifacts
+- a documentation view with searchable built-in docs
+- a slide-out activity drawer for live run events
+
+## Transparency
+
+- The dashboard is a local HTTP service, not a hosted cloud control panel.
+- Saving or autosaving a session writes JSON state to `~/.asrfacet_rb/web_sessions/`.
+- Starting a run from the browser triggers the same real recon pipeline used by the CLI.
+- Reports, event streams, and recon memory still live under the normal `~/.asrfacet_rb/output/` and `~/.asrfacet_rb/memory/` paths.
+- The UI helps inspect sessions more easily, but it does not change the framework's authorization requirements or guarantee completeness.
+
 ## Session Persistence
 
 Session drafts are stored under:
@@ -62,13 +81,3 @@ Completed sessions expose links for:
 - JSON report
 
 These are served from the stored artifact bundle on disk and remain available after the run completes.
-
-## Themes
-
-The dashboard ships with:
-
-- Light
-- Dark
-- Grey
-
-Theme selection is stored locally in the browser so the UI returns to the last operator preference.

lib/asrfacet_rb/core/integrity_checker.rb

@@ -30,6 +30,7 @@ class IntegrityChecker
 
       OPTIONAL_PATHS = [
         "man/asrfacet-rb.1",
+        "man/asrfrb.1",
         "README.md"
       ].freeze
 

lib/asrfacet_rb/ui/cli.rb

@@ -62,14 +62,17 @@ def start(given_args = ARGV, config = {})
           if args.delete("--web-session")
             return super(["web", *args], config)
           end
-          if args.delete("--about")
-            return super(["about", *args], config)
-          end
-          if (index = args.index("--explain"))
-            topic = args[index + 1].to_s
-            args.slice!(index, 2)
-            return super(["explain", topic, *args], config)
-          end
+        if args.delete("--about")
+          return super(["about", *args], config)
+        end
+        if args.delete("--version")
+          return super(["version", *args], config)
+        end
+        if (index = args.index("--explain"))
+          topic = args[index + 1].to_s
+          args.slice!(index, 2)
+          return super(["explain", topic, *args], config)
+        end
 
           super(args, config)
         rescue StandardError

lib/asrfacet_rb/ui/help_catalog.rb

@@ -320,25 +320,26 @@ module HelpCatalog
         },
         "version" => {
           summary: "Print the currently installed ASRFacet-Rb version.",
-          usage: "asrfacet-rb version",
+          usage: "asrfacet-rb --version",
           details: [
             "Use this when validating the local CLI version before running a scan or sharing results."
           ],
           examples: [
-            "asrfacet-rb version"
+            "asrfacet-rb --version"
           ]
         },
         "manual" => {
           summary: "Read the framework manual or a specific section.",
           usage: "asrfacet-rb manual [section]",
           details: [
             "Use the built-in manual when you want a structured reference for commands, workflow, configuration, outputs, and recon concepts.",
-            "The same content also ships as a man page source under man/asrfacet-rb.1."
+            "The same content also ships as man page sources under man/asrfacet-rb.1 and man/asrfrb.1."
           ],
           examples: [
             "asrfacet-rb manual",
             "asrfacet-rb manual workflow",
-            "man asrfacet-rb"
+            "man asrfacet-rb",
+            "man asrfrb"
           ]
         },
         "wizard" => {
@@ -401,6 +402,7 @@ module HelpCatalog
         "--delay" => "delay",
         "--adaptive-rate" => "adaptive-rate",
         "--about" => "about",
+        "--version" => "version",
         "--explain" => "explain",
         "--memory" => "memory",
         "--top" => "top",
@@ -472,7 +474,7 @@ def menu(executable: PRIMARY_EXECUTABLE)
           "  explain TOPIC      Explain a command or topic          Aliases: x, exp",
           "  help [TOPIC]       Show the help menu                  Aliases: h, ?",
           "  manual [SECTION]   Read the built-in manual            Aliases: m, man",
-          "  version            Print the installed version         Aliases: v, ver",
+          "      --version      Print the installed version         Command: version | Aliases: v, ver",
           "",
           "Global options:",
           "  -o, --output PATH  Save output to a file instead of printing",

lib/asrfacet_rb/ui/manual.rb

@@ -28,6 +28,7 @@ module Manual
         configurations
         outputs
         files
+        transparency
         safety
         examples
       ].freeze
@@ -36,17 +37,19 @@ module Manual
         "name" => {
           title: "NAME",
           body: [
-            "asrfacet-rb - authorized attack surface reconnaissance and security mapping framework for Ruby 3.2+"
+            "asrfacet-rb, asrfrb - authorized attack surface reconnaissance and security mapping framework for Ruby 3.2+"
           ]
         },
         "synopsis" => {
           title: "SYNOPSIS",
           body: [
             "asrfacet-rb <command> [arguments] [options]",
+            "asrfacet-rb --version",
             "asrfacet-rb --console",
             "asrfacet-rb --web-session",
             "asrfacet-rb manual [section]",
-            "man asrfacet-rb"
+            "man asrfacet-rb",
+            "man asrfrb"
           ]
         },
         "description" => {
@@ -189,7 +192,19 @@ module Manual
             "~/.asrfacet_rb/web_sessions/",
             "  Persistent web-session drafts, run state, and recovered sessions for the local control panel.",
             "man/asrfacet-rb.1",
-            "  Manual page source for `man asrfacet-rb` on systems where the man page is installed or the repository man directory is on MANPATH."
+            "  Manual page source for `man asrfacet-rb` on systems where the man page is installed or the repository man directory is on MANPATH.",
+            "man/asrfrb.1",
+            "  Alias man page source for `man asrfrb`."
+          ]
+        },
+        "transparency" => {
+          title: "TRANSPARENCY",
+          body: [
+            "Active modes make real DNS, TCP, HTTP, and related requests to the targets you configure.",
+            "Passive results are lead generation, not guaranteed truth. They may include stale records, inherited infrastructure, or shared services that are not automatically authorized.",
+            "The local web session starts a local HTTP server, stores drafts under ~/.asrfacet_rb/web_sessions/, and writes reports and streams to the normal output directories.",
+            "Findings, scores, and recommendations are operator aids. They do not prove exploitability, ownership, or business impact on their own.",
+            "ASRFacet-Rb does not claim stealth, evasion, or complete coverage. Operators must still define scope, exclusions, and verification steps explicitly."
           ]
         },
         "safety" => {
@@ -212,7 +227,8 @@ module Manual
             "asrfacet-rb --explain scope",
             "asrfacet-rb scan example.com --scope example.com,api.example.com --exclude dev.example.com --monitor",
             "asrfacet-rb --console",
-            "man asrfacet-rb"
+            "man asrfacet-rb",
+            "man asrfrb"
           ]
         }
       }.freeze