Initial commit: Wonderware / System Platform tools and reference

Five tools under one repo, all docs organized per DOCS-GUIDE.md:

- aalogcli: .NET 4.8 / x86 CliFx CLI for reading System Platform binary
  logs (*.aaLGX) for LLM debugging, built on aaOpenSource/aaLog. Commands:
  last, tail, range, unread, fields. Stable JSON envelope under --llm-json.
  Build template under lib/build/ for rebuilding aaLogReader.dll.

- aot: ArchestrA Object Toolkit 2014 v4.0 reference material. Dev guide
  (Markdown converted from CHM), API reference for the ArchestrA.Toolkit
  namespace, and the Monitor / Watchdog VS sample solutions.

- graccesscli: .NET 4.8 / x86 CliFx CLI that automates Galaxy
  configuration via the ArchestrA GRAccess COM interop. Includes session
  daemon, IPC protocol, and llm-json envelope contract.

- grdb: SQL/DDL exploration of the Galaxy Repository database. DDL
  captures, reusable queries, hierarchy / contained-name <-> tag-name
  translation notes.

- histdb: LLM-oriented reference for AVEVA Historian retrieval. INSQL
  linked-server, extension tables, every wwXxx time-domain extension,
  every retrieval mode, alarm/event SQL recipes, REST API. Distilled
  from the 243-page Historian Retrieval Guide.

Root contains:
- CLAUDE.md: thin index pointing into each tool's README.
- DOCS-GUIDE.md: doctrine for organizing docs for LLM consumption.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

aalogcli/src/AaLog.Cli/Commands/CommonOptions.cs

@@ -0,0 +1,28 @@
+using CliFx.Attributes;
+
+namespace AaLog.Cli.Commands
+{
+    /// Shared option set inherited by every read command. Kept as an abstract base so
+    /// CliFx still treats each subclass as a distinct command, but option declarations
+    /// only live in one place.
+    public abstract class ReadCommandBase
+    {
+        [CommandOption("log-dir", Description = "Override the log directory. Defaults to C:\\ProgramData\\ArchestrA\\LogFiles.")]
+        public string LogDirectory { get; init; }
+
+        [CommandOption("component", Description = "Substring (or regex with --regex) to match against the Component field.")]
+        public string Component { get; init; }
+
+        [CommandOption("level", Description = "Substring (or regex with --regex) to match against the Level / LogFlag field (Info, Warning, Error, ...).")]
+        public string Level { get; init; }
+
+        [CommandOption("message", Description = "Substring (or regex with --regex) to match against the Message body.")]
+        public string Message { get; init; }
+
+        [CommandOption("regex", Description = "Treat --component / --level / --message as regular expressions instead of substrings.")]
+        public bool UseRegex { get; init; }
+
+        [CommandOption("llm-json", Description = "Emit a stable JSON envelope { query, count, records } instead of human-readable lines.")]
+        public bool LlmJson { get; init; }
+    }
+}