chore: add UX infrastructure (quickstart, doctor, setup)

Added by ux-rollout.jl batch script.

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

Author: hyperpolymath

QUICKSTART-DEV.adoc

@@ -0,0 +1,39 @@
+= Verisimdb — Developer Quickstart
+:toc: preamble
+
+Clone, build, test, contribute.
+
+== Prerequisites
+
+* Git 2.40+
+* just (command runner)
+* See `just doctor` output for language-specific requirements
+
+== Setup
+
+[source,bash]
+----
+git clone https://github.com/hyperpolymath/verisimdb
+cd verisimdb
+just doctor    # verify toolchain
+just heal      # auto-install missing tools
+----
+
+== Development Workflow
+
+[source,bash]
+----
+just tour      # understand the codebase
+just help-me   # see available commands
+----
+
+== Before Committing
+
+[source,bash]
+----
+just assail    # run panic-attacker security scan
+----
+
+== Contributing
+
+See link:CONTRIBUTING.md[CONTRIBUTING.md] for guidelines.

QUICKSTART-MAINTAINER.adoc

@@ -0,0 +1,40 @@
+= Verisimdb — Maintainer Quickstart
+:toc: preamble
+
+Packaging, deployment, and release management.
+
+== Prerequisites
+
+* Git 2.40+
+* just (command runner)
+* Familiarity with the project (run `just tour` first)
+
+== CI/CD
+
+This project uses GitHub Actions. Workflows are in `.github/workflows/`.
+
+Key workflows:
+
+* `hypatia-scan.yml` — Neurosymbolic security scanning
+* `codeql.yml` — Code analysis
+* `scorecard.yml` — OpenSSF Scorecard
+* `mirror.yml` — GitLab/Bitbucket mirroring
+
+== Releasing
+
+1. Update version in project config
+2. Update CHANGELOG.md
+3. Tag: `git tag -s v<VERSION>`
+4. Push: `git push origin main --tags`
+
+== Container Build (if applicable)
+
+[source,bash]
+----
+podman build -f Containerfile -t verisimdb:latest .
+----
+
+== Mirrors
+
+This repo is mirrored to GitLab and Bitbucket (hyperpolymath accounts)
+via the `mirror.yml` workflow.

contractiles/intend/Intentfile.a2ml

@@ -0,0 +1,22 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Intentfile (A2ML Canonical)
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath)
+
+@abstract:
+Declared intent and purpose for Verisimdb.
+@end
+
+## Purpose
+
+Verisimdb — // SPDX-License-Identifier: PMPL-1.0-or-later
+
+## Anti-Purpose
+
+This project is NOT:
+- A fork or wrapper around another tool
+- A monorepo (unless explicitly structured as one)
+
+## If In Doubt
+
+If you are unsure whether a change is in scope, ask.
+Sensitive areas: ABI definitions, license headers, CI workflows.

setup.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath)
+#
+# Verisimdb — Universal Setup Script
+# Detects platform and shell, installs just, then hands off to Justfile.
+
+set -euo pipefail
+
+echo "═══════════════════════════════════════════════════"
+echo "  Verisimdb — Setup"
+echo "═══════════════════════════════════════════════════"
+echo ""
+
+# Platform detection
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+echo "Platform: $OS $ARCH"
+
+# Shell detection
+CURRENT_SHELL="$(basename "$SHELL" 2>/dev/null || echo "unknown")"
+echo "Shell: $CURRENT_SHELL"
+echo ""
+
+# Check for just
+if ! command -v just >/dev/null 2>&1; then
+    echo "just (command runner) is required but not installed."
+    echo ""
+    case "$OS" in
+        Linux)
+            if command -v cargo >/dev/null 2>&1; then
+                echo "Installing just via cargo..."
+                cargo install just
+            elif command -v brew >/dev/null 2>&1; then
+                echo "Installing just via Homebrew..."
+                brew install just
+            else
+                echo "Install just from: https://just.systems/man/en/installation.html"
+                exit 1
+            fi
+            ;;
+        Darwin)
+            if command -v brew >/dev/null 2>&1; then
+                echo "Installing just via Homebrew..."
+                brew install just
+            else
+                echo "Install Homebrew first: https://brew.sh"
+                echo "Then: brew install just"
+                exit 1
+            fi
+            ;;
+        *)
+            echo "Install just from: https://just.systems/man/en/installation.html"
+            exit 1
+            ;;
+    esac
+    echo ""
+fi
+
+echo "Running diagnostics..."
+just doctor
+
+echo ""
+echo "Setup complete. Run 'just help-me' for common workflows."