Changelog

Build: @antora-supplemental/facto-stack v0.4.1 (antora-search-chat v0.1.26): the search box corners no longer show the search surface color in light and dark mode.

Build: @antora-supplemental/facto-stack v0.4.0, which brings antora-search-chat v0.1.25 (readable search dropdown in dark mode; light mode unchanged) and runs the built-in contrast check (contrast-check-v0.3.0) on every build in light and dark mode with the search results open. The build fails on dark-mode and search-state WCAG AA errors; other findings are reported only. No workflow change. contrast-check.suppress.json (wired through the contrastCheck pack key) accepts the existing dark-mode findings in page-context labels, highlight.js shell colors and the link-validator report select until 2027-01-31; they are follow-ups upstream.

UI: Valentus v4.3.1. The current page in the breadcrumb is no longer underlined.

Changelog: moved from the root CHANGELOG.adoc into the changelog module of the open-shell-org component (Changelog in the nav). Detail reports and saved prompts go under changelog-details/history/.

Concept page NS-6: the resolver command is literally install; install(1) lives at legacy/install with a PROVISIONAL passthrough.

New CLI Help standard (CH-1 to CH-24), based on prohelp: --help, -h and help (as a command for tools with subcommands) must print help; bare invocation; progressive content and line budgets; an authored prohelp document as the source of truth, rendered through prohelp.intercept and gated by prohelp check --strict; subcommand help; help on stdout with exit 0, error help on stderr with exit 2; text subtree dump and (provisional) JSON help; did-you-mean ties to CD-1. Lists the features prohelp 0.2.3 still needs. Listed under The Standard next to CLI Dispatch; CLI Dispatch CD-1, CD-5, CD-6, CD-8 and CD-16 link to the CH rules; CLI Dispatch conformance gains help self-test rows.

UI: Valentus v4.3.0 and @antora-supplemental/facto-stack v0.3.1 (mermaid-client / diagram-lightbox -v0.2.2 tags). The hub fixes moved upstream, so the hub copies are gone: site-inline-title-code.css, site-nav-column-scroll.css, site-math.js, site-toc-main-article.js, in-site-nav-tree.js and the breadcrumbs.hbs override. The breadcrumb component filter is now the Valentus opt-in site key valentus_bc_components: site-nav-tree. head-meta.hbs is resynced to Valentus 4.3.0 plus the hub additions.

Playbook: the ns tool is renamed name (repo openshellorg/name). Concept page NS-2 notes JSON5 manifests; NS-7 records the decided + free-flag sigil.

Playbook: add the Tools components from command-namespace, ns, install, versions and isolate.

New proposed concept page Command namespace and context requests (NS-1 to NS-14): hierarchical command namespace instead of PATH, input signatures for context requests (current folder as declared input), fixed-height composition area, isolation levels (overlay, fence, partition, guest). Listed under Concepts (proposed) in the nav.

New CLI Dispatch standard (CD-1 to CD-12): unknown commands are usage errors (stderr, exit 2, did-you-mean); no implicit catch-all for bare words; documented and announced bare-invocation defaults (help preferred); no-argument tools and GUI launchers reject any input; wrappers forward only known commands and name the tool that implements the rest; mandatory migration (warn on every implicit use plus strict opt-in now, strict by default next major). Non-normative note on CLI styles, worked dub/redub example and conformance checklist. Listed under The Standard in the nav and cross-linked from CLI Output.

Float @antora-supplemental/facto-stack on rolling minor git pin #v0.2 (resolves v0.2.64 today).

New CLI Output standard (CO-1 to CO-20): default output shows only outcome, changes, decisions and the log path; failures explain themselves inline; sectioned logs, --verbose, --json / JSON Lines, per-OS log locations, prompts, exit codes, and stdout/stderr use. Listed under The Standard in the nav.

Pin @antora-supplemental/facto-stack v0.2.40 (search bar stays on screen above the footer).

pnpm antora installs when the lockfile is newer than node_modules (git tag bumps). It does not move the facto-stack pin by itself; pull the repo first.

Pin @antora-supplemental/facto-stack v0.2.39 (Windows disk search uses a dialog instead of the Y/n banner).

Pin @antora-supplemental/facto-stack v0.2.38 (disk-search banner wraps inside the frame).

Pin @antora-supplemental/facto-stack v0.2.37 (disk-search banner prints once, as ASCII, on Windows).

Pin @antora-supplemental/facto-stack v0.2.36 (opaque search chrome).

Compose pack + local content. Single @antora-supplemental/facto-stack v0.2.34 require (hub profile); removed antora-playbook-local.yml. Local clones via pack-registered antora-local-content-sources. Hub .antora-source-id for clone discovery.

Config Lifecycle Management page credits Ryan Johnson (page-orig-author-github / page-last-author-github: AMDphreak) — supersedes PR #6.

Register @antora-supplemental/asciidoctor-emoji-literals before official npm asciidoctor-emoji 0.5.x so pasted Unicode emoji in AsciiDoc render as Twemoji (interim until asciidoctor-emoji 1.x on @asciidoctor/core 4). Aligned with facto-stack playbook.fragment.yml.

Refreshed deprecated transitive dependencies within existing ranges: @ungap/structured-clone 1.4.0 and tar 7.5.22.

New Design Considerations page with an AI Compatibility Concerns section and normative Text Encoding requirements TE-1 to TE-8: UTF-8 by default for files, pipes and console; no silent transcoding; loud explicit legacy opt-in; byte-order mark handling; round-trip safety; machine-readable encoding errors; discoverable effective encodings.

Mandatory Protocols links the text encoding requirements; nav lists Design Considerations under The Standard.

Tools ROOT landing page-last-author credits Ryan Johnson (page-last-author-github: AMDphreak).

Pin @antora-supplemental/page-context to v0.6.9; playbook attributes page-context-author-label: username and page-context-author-avatar: without-icon.

Tools ROOT landing credits Ryan Johnson (page-orig-author-github: AMDphreak) instead of the org placeholder.

Supplemental CSS styles <code> inside page H1, side-nav labels, and Valentus breadcrumb trail text (AsciiDoc backticks in doctitles and nav xref labels).

Add hub-owned docs-tools/ scaffold (name: tools) with ROOT landing page; site-nav-tree lists a single tools root instead of per-CLI components.

Remove Desktop-Tooling/grammaton-ui-shell from playbook content sources; Ecosystem treats Grammaton as an external cousin, not an OSO Tools member.

Ecosystem and hub xrefs use tools:<module>: for companion CLIs and libraries (sibling repos migrate to name: tools + modules/<id>/).

Adopt @antora-supplemental/facto-stack wiring: indexify URLs, site-nav-tree curated sidebar roots, nav-typology (+ Diátaxis), page-context/edit, link-validator, linkinator, extension-lister, orphan-finder, build-stack footer, client Mermaid + diagram lightbox, Kroki bake for non-Mermaid diagrams.

Playbook content source: openshellorg/actor-shell → Desktop-Tooling/grammaton-ui-shell (component grammaton-ui-shell).

Supplemental UI: nav-tree / typology partials and helpers from the Facto compose pattern (DevCentr reference).

Diagram rendering engines (Facto): @antora-supplemental/mermaid-client + @antora-supplemental/diagram-lightbox from antora-diagram-engines for [source,mermaid]; asciidoctor-kroki for PlantUML/other Kroki types; no alternate AsciiDoc renderers.

Hub diagram CI: themed-svg runtime sync, static dark-text audit, verifier tests, and Antora verify-themed-svg-dark-mode — does not clone upstream to re-run diagrams:check / mermaid-cli (bake freshness stays in product repos). Documented in [CONTRIBUTING.md](CONTRIBUTING.md) and [scripts/DIAGRAM-AUDITS.md](scripts/DIAGRAM-AUDITS.md).

The protocol page is now Config Lifecycle Management; the old standard-config-key-sanitation URL redirects to it.

Companion library renamed to config-lifecycle (old repo URL redirects).

Status label roles renamed from .cks-status- to .lifecycle-status- (site-lifecycle-status.css).

Colorize lifecycle status labels in Config Key Sanitation (.cks-status-* + supplemental CSS).

New mandatory protocol Config Key Sanitation: never drop detection of outdated config keys; deprecate → expire with ongoing alerts; ship machine-readable key indexes.

Mandatory Protocols summarizes the rule and links the full text.

Ecosystem: list companion library config-key-sanitation.

Pin @antora-supplemental/page-edit to v0.2.4 so Antora component start pages get the Source | View | Edit row (empty lead shells no longer false-positive on page-context CSS).

Pin @antora-supplemental/page-edit to v0.2.3 (was stale #main lock at 0.1.0) so View | Edit is not prepended before the HTML DOCTYPE.

Antora site.robots now emits /robots.txt with an absolute Sitemap: line for the production host.

Progressively upgrade marked shell-architecture image blocks from adaptive SVG images to sanitized host SVGs using @dev-centr/themed-svg 0.1.1.

Ecosystem: link Tool runs and diagnostics and Command channels.

Related footer: one homepage link per org (OpenShellOrg, DevCentr); drop docs/GitHub duplicates.

Philosophy + Ecosystem: PlayTime (Dev-Centr scriptbook) rhymes with argv honesty / host identity; engine is not in this hub yet.

Essays live in shell-architecture: PlayTime at the shell boundary, argv as execution currency, host identity as a contract.

Enable stem: latexmath and KaTeX (site-math.js) on every docs page, even when unused

Ecosystem page: link connectome-fs shell query / compatibility projection; list Graph navigation and Hierarchical projection.

Site URL is https://docs.opensh.org (Pages CNAME).

Rename hub repository to docs (local + remote), matching Dev-Centr; Antora site base is now /docs/. Antora hub component id remains open-shell-org.

Assemble terminal-gui-prompts Antora component into the docs playbooks; list it under Orientation and help on the Ecosystem page.

Assemble actor-shell Antora component into the docs playbooks; list it under Planned / forked products on the Ecosystem page.

Ecosystem page: planned/forked products — env-refresh + openshellorg/terminal (Windows Terminal fork; per-tab env health + Fix/Insert bar).

Add Philosophy page for Dev-Centr alignment and name-collision notes; keep profile visitor-facing.

Pin Valentus UI bundle to the rolling v2 release line (not exact v2.0.0).

Assemble multi-repo Antora docs (shell-architecture, nu-*, about, info, prohelp, prohelp-cli).

Replace Starlight docs app with Antora + Valentus theme 2.0.0 and Pages CI.

Add brand assets (assets/brand/), .vscode settings, and dprint.jsonc.

Remove open-shell-org.code-workspace in favor of .vscode.