From 8e70012eb80a265e296058266d3cf897397a8c06 Mon Sep 17 00:00:00 2001 From: Volker Christian Date: Thu, 15 Oct 2026 04:34:19 +0200 Subject: [PATCH] Link README navigation to banners and use named identity buttons --- AGENTS.md | 2 +- README.md | 33 +++++------ docs/README.md | 56 +++++++++---------- docs/architecture/README.md | 22 ++++---- docs/architecture/app-server-data-model.md | 6 +- docs/architecture/overview.md | 10 ++-- docs/architecture/qt-ui-audit.md | 6 +- .../qt-virtualized-conversation-view.md | 4 +- docs/architecture/remediation/README.md | 8 +-- .../remediation/findings-ledger/README.md | 16 +++--- .../findings-ledger/current-repair-plan.md | 4 +- .../findings-ledger/findings-and-crosswalk.md | 4 +- .../findings-ledger/historical-record.md | 4 +- .../findings-ledger/s5-middle-region-audit.md | 4 +- .../findings-ledger/s5-resumed-worktree.md | 4 +- .../findings-ledger/s5-shared-foundations.md | 4 +- .../architecture/remediation/thread-prompt.md | 4 +- docs/architecture/reviews/README.md | 10 ++-- docs/architecture/reviews/chatgpt.md | 4 +- docs/architecture/reviews/claude-a.md | 4 +- docs/architecture/reviews/claude-b.md | 4 +- docs/architecture/shared-node-graph.md | 6 +- docs/architecture/timestamp-presentation.md | 6 +- docs/architecture/ui-internal-api.md | 4 +- docs/guides/README.md | 10 ++-- docs/guides/build-from-source.md | 10 ++-- docs/guides/interaction-guide.md | 10 ++-- docs/guides/thread-projects.md | 8 +-- docs/media/nav/account-dark.svg | 22 ++++++++ docs/media/nav/account-icon-dark.svg | 22 ++++++++ docs/media/nav/account-icon-light.svg | 22 ++++++++ docs/media/nav/account-light.svg | 22 ++++++++ docs/media/nav/organization-dark.svg | 2 +- docs/media/nav/organization-light.svg | 2 +- docs/media/nav/repository-dark.svg | 2 +- docs/media/nav/repository-light.svg | 2 +- docs/media/nav/up-findings-ledger-dark.svg | 4 +- docs/media/nav/up-findings-ledger-light.svg | 4 +- docs/qualification/README.md | 8 +-- .../native-results-2026-09-27.md | 6 +- docs/qualification/native-test-suite.md | 6 +- docs/records/README.md | 12 ++-- .../codex-0.162.1-migration-inventory.md | 6 +- .../codex-0.162.1-migration-results.md | 6 +- docs/records/thread-projects-verification.md | 6 +- docs/records/timestamp-verification.md | 4 +- docs/ui-review/README.md | 14 ++--- docs/ui-review/code-polish-roadmap.md | 4 +- docs/ui-review/state-matrix.md | 4 +- docs/ui-review/thread-turn-model.md | 4 +- docs/ui-review/ui-inventory.md | 6 +- docs/ui-review/ux-decisions.md | 6 +- docs/web/README.md | 10 ++-- docs/web/contract-1.0.md | 4 +- docs/web/qualification.md | 8 +-- docs/web/release-process.md | 4 +- web/README.md | 6 +- 57 files changed, 292 insertions(+), 203 deletions(-) create mode 100644 docs/media/nav/account-dark.svg create mode 100644 docs/media/nav/account-icon-dark.svg create mode 100644 docs/media/nav/account-icon-light.svg create mode 100644 docs/media/nav/account-light.svg diff --git a/AGENTS.md b/AGENTS.md index e0487cb..147d19c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ The global engineering instructions in `~/.codex/AGENTS.md` apply in full. ## Required reading: native interactive qualification -[Canonical interactive Xvfb test suite and visual approval matrix](docs/qualification/native-test-suite.md). +[Canonical interactive Xvfb test suite and visual approval matrix](docs/qualification/native-test-suite.md#banner). ## Markdown formatting diff --git a/README.md b/README.md index 0696094..139e09d 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,4 @@ + @@ -9,7 +10,7 @@

-

SNode.C organization

+

Volker Christian accountSNode.C organizationCodexUI repository

# Codex(W)UI @@ -26,13 +27,13 @@ **Follow the work, not just the final answer.** Codex(W)UI offers two frontends: **CodexUI**, a native Qt desktop application, and **CodexWUI**, a browser application connecting over WebSocket. They bring conversations, commands, plans, approvals and file changes into a visual coding workspace. -Built on [AISuite](https://github.com/SNodeC/AISuite#project-overview) and [SNode.C](https://github.com/SNodeC/snode.c#project-overview), both frontends connect through AISuite's `codex-bridge`. Codex app-server remains responsible for agent execution and persistent history; both applications give you the controls and visibility around it. +Built on [AISuite](https://github.com/SNodeC/AISuite#banner) and [SNode.C](https://github.com/SNodeC/snode.c#banner), both frontends connect through AISuite's `codex-bridge`. Codex app-server remains responsible for agent execution and persistent history; both applications give you the controls and visibility around it.

Start Install - Build + Build Use Configure Architecture @@ -72,7 +73,7 @@ In the native threads panel, **projects contain the visual grouping; sections or To create a project or section, click the current grouping label—**Projects**, **Sections** or **Ungrouped**—above the thread list. Use a thread's context menu to assign its project and section. Creation and assignment require controller access and server support. -Next: [read the grouping and lifecycle guide](docs/guides/thread-projects.md#page-overview). +Next: [read the grouping and lifecycle guide](docs/guides/thread-projects.md#banner). ### Choose your frontend @@ -98,7 +99,7 @@ Build [native Qt desktop](docs/guides/build-from-source.md#native-desktop) or [b ### Native desktop -**You need:** the native build, a configured Codex executable available to the bridge user, and AISuite's `codex-bridge`. The bridge's generated protocol targets Codex 0.162.1; use the [AISuite entry page](https://github.com/SNodeC/AISuite#project-overview) to check compatibility before changing Codex versions. +**You need:** the native build, a configured Codex executable available to the bridge user, and AISuite's `codex-bridge`. The bridge's generated protocol targets Codex 0.162.1; use the [AISuite entry page](https://github.com/SNodeC/AISuite#banner) to check compatibility before changing Codex versions. Start `codex-bridge --config-file /dev/null` as your own user in one terminal. In a second terminal, run from this checkout: @@ -144,30 +145,30 @@ The bridge allows multiple frontends to follow the same app-server session, with On the native side, a SNode.C worker owns protocol processing and writes one shared `NodeGraph`; Qt projects that state into widgets. The browser uses AISuite's TypeScript SDK and its own presentation state. Neither frontend replaces app-server's persistent history or tool execution. -For the detailed state, threading and protocol boundaries, see the [architecture guide](docs/architecture/overview.md#page-overview). +For the detailed state, threading and protocol boundaries, see the [architecture guide](docs/architecture/overview.md#banner). ## Documentation -Manual CI builds and qualifies the desktop and browser editions, including shared verification and frontend SDK checks. See the organization [workflow graph](https://github.com/SNodeC/.github/blob/main/docs/workflow-graph.md#page-overview) for triggers and artifact boundaries. +Manual CI builds and qualifies the desktop and browser editions, including shared verification and frontend SDK checks. See the organization [workflow graph](https://github.com/SNodeC/.github/blob/main/docs/workflow-graph.md#banner) for triggers and artifact boundaries. -[Documentation index](docs/README.md#page-overview): guides, architecture, qualification and engineering records for CodexUI. +[Documentation index](docs/README.md#banner): guides, architecture, qualification and engineering records for CodexUI. | Start here | Go deeper | | --- | --- | -| [Using CodexUI](docs/guides/interaction-guide.md#page-overview) | [Native state and threading](docs/architecture/shared-node-graph.md#page-overview) | -| [Projects and sections](docs/guides/thread-projects.md#page-overview) | [Architecture overview](docs/architecture/overview.md#page-overview) | -| [Timestamps and durations](docs/architecture/timestamp-presentation.md#page-overview) | [Browser contract](docs/web/contract-1.0.md#page-overview) | -| [Browser build and deployment](web/README.md#page-overview) | [Web qualification](docs/web/qualification.md#page-overview) · [Release process](docs/web/release-process.md#page-overview) | +| [Using CodexUI](docs/guides/interaction-guide.md#banner) | [Native state and threading](docs/architecture/shared-node-graph.md#banner) | +| [Projects and sections](docs/guides/thread-projects.md#banner) | [Architecture overview](docs/architecture/overview.md#banner) | +| [Timestamps and durations](docs/architecture/timestamp-presentation.md#banner) | [Browser contract](docs/web/contract-1.0.md#banner) | +| [Browser build and deployment](web/README.md#banner) | [Web qualification](docs/web/qualification.md#banner) · [Release process](docs/web/release-process.md#banner) | For bug reports, include the revision, Qt version, connection type and the smallest reproducible sequence. Remove credentials and private conversation content from logs and screenshots. ## Platforms -The documented native platform is Linux with Qt 6.6+ Widgets. Browser frontend scope, coverage and limitations are defined by the [browser contract](docs/web/contract-1.0.md#page-overview); they are not a promise of native/browser feature parity. Review the [known limitations](docs/guides/interaction-guide.md#known-limitations) before relying on approval handling or native performance. +The documented native platform is Linux with Qt 6.6+ Widgets. Browser frontend scope, coverage and limitations are defined by the [browser contract](docs/web/contract-1.0.md#banner); they are not a promise of native/browser feature parity. Review the [known limitations](docs/guides/interaction-guide.md#known-limitations) before relying on approval handling or native performance. ## Releases -No GitHub release or shared binary-package distribution is published yet; the documented installation routes build from source. Future release notes belong on the [releases page](https://github.com/SNodeC/CodexUI/releases). The [web release process](docs/web/release-process.md#page-overview) describes development qualification, not a downloadable product release. +No GitHub release or shared binary-package distribution is published yet; the documented installation routes build from source. Future release notes belong on the [releases page](https://github.com/SNodeC/CodexUI/releases). The [web release process](docs/web/release-process.md#banner) describes development qualification, not a downloadable product release. ## Contributing @@ -178,7 +179,7 @@ No GitHub release or shared binary-package distribution is published yet; the do ## Ecosystem -Depends on [AISuite](https://github.com/SNodeC/AISuite#project-overview) and [SNode.C](https://github.com/SNodeC/snode.c#project-overview) +Depends on [AISuite](https://github.com/SNodeC/AISuite#banner) and [SNode.C](https://github.com/SNodeC/snode.c#banner) @@ -186,5 +187,5 @@ Choose either [MIT](LICENSE-MIT) or [LGPL-3.0-or-later](LICENSE-LGPL-3.0-or-late Built with [Qt](https://www.qt.io/). Codex(W)UI is an independent project; neither frontend is an official OpenAI application. -Maintainer: [Volker Christian](https://github.com/VolkerChristian). [Organization](https://github.com/SNodeC) · [Contributing](#contributing) · [Security](https://github.com/SNodeC/.github/blob/main/SECURITY.md) +Maintainer: [Volker Christian](https://github.com/VolkerChristian#banner). [Organization](https://github.com/SNodeC#banner) · [Contributing](#contributing) · [Security](https://github.com/SNodeC/.github/blob/main/SECURITY.md) diff --git a/docs/README.md b/docs/README.md index 4e17926..3027345 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Documentation

-

Up to CodexUISNode.C organizationCodexUI repository

+

Up to CodexUIVolker Christian accountSNode.C organizationCodexUI repository

# Codex(W)UI documentation @@ -10,7 +10,7 @@

Start Install - Build + Build Use Configure Architecture @@ -24,39 +24,39 @@ Start with the [repository README](../README.md#quick-start) for a first working ## Sections -- [Architecture](architecture/README.md#page-overview) -- [Guides](guides/README.md#page-overview) -- [Qualification](qualification/README.md#page-overview) -- [Records](records/README.md#page-overview) -- [UI review](ui-review/README.md#page-overview) -- [Web UI](web/README.md#page-overview) +- [Architecture](architecture/README.md#banner) +- [Guides](guides/README.md#banner) +- [Qualification](qualification/README.md#banner) +- [Records](records/README.md#banner) +- [UI review](ui-review/README.md#banner) +- [Web UI](web/README.md#banner) ## User guides and references -- [Build and install from source](guides/build-from-source.md#page-overview) -- [Using CodexUI](guides/interaction-guide.md#page-overview) -- [Projects and sections](guides/thread-projects.md#page-overview) -- [Architecture overview](architecture/overview.md#page-overview) -- [Timestamp presentation](architecture/timestamp-presentation.md#page-overview) -- [Browser contract](web/contract-1.0.md#page-overview) -- [Browser build and deployment](../web/README.md#page-overview) -- [Web release process](web/release-process.md#page-overview) +- [Build and install from source](guides/build-from-source.md#banner) +- [Using CodexUI](guides/interaction-guide.md#banner) +- [Projects and sections](guides/thread-projects.md#banner) +- [Architecture overview](architecture/overview.md#banner) +- [Timestamp presentation](architecture/timestamp-presentation.md#banner) +- [Browser contract](web/contract-1.0.md#banner) +- [Browser build and deployment](../web/README.md#banner) +- [Web release process](web/release-process.md#banner) ## Design and engineering records These documents describe implementation decisions, qualification scope or historical evidence; they are not prerequisites for first use and do not establish that current builds passed every check. -- [Native state and threading](architecture/shared-node-graph.md#page-overview) -- [Web qualification](web/qualification.md#page-overview) -- [Interactive qualification inventory](qualification/native-test-suite.md#page-overview) -- [Qualification execution record](qualification/native-results-2026-09-27.md#page-overview) -- [Native architecture audit](architecture/qt-ui-audit.md#page-overview) -- [Virtualized conversation view](architecture/qt-virtualized-conversation-view.md#page-overview) -- [Internal UI APIs](architecture/ui-internal-api.md#page-overview) -- [Thread projects verification](records/thread-projects-verification.md#page-overview) -- [Timestamp verification](records/timestamp-verification.md#page-overview) -- [Codex 0.162.1 migration inventory](records/codex-0.162.1-migration-inventory.md#page-overview) -- [Codex 0.162.1 local migration results](records/codex-0.162.1-migration-results.md#page-overview) +- [Native state and threading](architecture/shared-node-graph.md#banner) +- [Web qualification](web/qualification.md#banner) +- [Interactive qualification inventory](qualification/native-test-suite.md#banner) +- [Qualification execution record](qualification/native-results-2026-09-27.md#banner) +- [Native architecture audit](architecture/qt-ui-audit.md#banner) +- [Virtualized conversation view](architecture/qt-virtualized-conversation-view.md#banner) +- [Internal UI APIs](architecture/ui-internal-api.md#banner) +- [Thread projects verification](records/thread-projects-verification.md#banner) +- [Timestamp verification](records/timestamp-verification.md#banner) +- [Codex 0.162.1 migration inventory](records/codex-0.162.1-migration-inventory.md#banner) +- [Codex 0.162.1 local migration results](records/codex-0.162.1-migration-results.md#banner) [Media assets](media/README.md). diff --git a/docs/architecture/README.md b/docs/architecture/README.md index d9c3347..76c3497 100644 --- a/docs/architecture/README.md +++ b/docs/architecture/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Architecture

-

Up to DocumentationSNode.C organizationCodexUI repository

+

Up to DocumentationVolker Christian accountSNode.C organizationCodexUI repository

# Architecture @@ -11,13 +11,13 @@ Architecture, internal contracts and design analyses of CodexUI. ## Sections -- [Historical Codex app-server protocol and proposed master data model](app-server-data-model.md#page-overview) -- [CodexUI architecture](overview.md#page-overview) -- [CodexUI Qt UI architecture and usability audit](qt-ui-audit.md#page-overview) -- [Qt virtualized conversation view](qt-virtualized-conversation-view.md#page-overview) -- [Remediation](remediation/README.md#page-overview) -- [Reviews](reviews/README.md#page-overview) -- [Shared node graph: writer, UI and projection readers](shared-node-graph.md#page-overview) -- [App-server timestamp presentation](timestamp-presentation.md#page-overview) -- [Native UI/UX internal API contract](ui-internal-api.md#page-overview) +- [Historical Codex app-server protocol and proposed master data model](app-server-data-model.md#banner) +- [CodexUI architecture](overview.md#banner) +- [CodexUI Qt UI architecture and usability audit](qt-ui-audit.md#banner) +- [Qt virtualized conversation view](qt-virtualized-conversation-view.md#banner) +- [Remediation](remediation/README.md#banner) +- [Reviews](reviews/README.md#banner) +- [Shared node graph: writer, UI and projection readers](shared-node-graph.md#banner) +- [App-server timestamp presentation](timestamp-presentation.md#banner) +- [Native UI/UX internal API contract](ui-internal-api.md#banner) diff --git a/docs/architecture/app-server-data-model.md b/docs/architecture/app-server-data-model.md index f91f254..acaea95 100644 --- a/docs/architecture/app-server-data-model.md +++ b/docs/architecture/app-server-data-model.md @@ -1,7 +1,7 @@ - +

CodexUI — Architecture

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# Historical Codex app-server protocol and proposed master data model @@ -11,7 +11,7 @@ > references. Its proposed journal, ledger, reducer, outbox, snapshot/cursor, > persistence, replay, and adapter runtime are rejected and are not CodexUI's > implemented architecture. The current native contract is -> [`../two-thread-shared-node-graph.md`](shared-node-graph.md#page-overview): one +> [`../two-thread-shared-node-graph.md`](shared-node-graph.md#banner): one > current shared `NodeGraph`, exactly two relevant threads, two typed SPSC > queues, and two Linux eventfds. diff --git a/docs/architecture/overview.md b/docs/architecture/overview.md index 3d8aedc..53b515c 100644 --- a/docs/architecture/overview.md +++ b/docs/architecture/overview.md @@ -1,7 +1,7 @@ - +

CodexUI — Architecture

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI architecture @@ -43,17 +43,17 @@ There is no internal JSONL, socketpair payload path, presentation model, mirror graph, snapshot history, or callback framework. The complete implemented native contract, ownership rules, protocol inventory, backpressure behavior, widget binding, and qualification are in -[two-thread-shared-node-graph.md](shared-node-graph.md#page-overview). +[two-thread-shared-node-graph.md](shared-node-graph.md#banner). Concrete interaction and rendering behavior is specified in -[ui-behavior.md](../guides/interaction-guide.md#page-overview). +[ui-behavior.md](../guides/interaction-guide.md#banner). ## Browser application The browser frontend connects to `codex-bridge` over WebSocket and has a separate TypeScript implementation appropriate to that process boundary. Its architecture, parity boundary, and limitations are documented in -[web-1.0-contract.md](../web/contract-1.0.md#page-overview). The native node graph is not a new +[web-1.0-contract.md](../web/contract-1.0.md#banner). The native node graph is not a new service or public protocol and is not shared with the browser. ## Local Git Changes diff --git a/docs/architecture/qt-ui-audit.md b/docs/architecture/qt-ui-audit.md index 88e6bfa..f43dab2 100644 --- a/docs/architecture/qt-ui-audit.md +++ b/docs/architecture/qt-ui-audit.md @@ -1,12 +1,12 @@ - +

CodexUI — Architecture

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI Qt UI architecture and usability audit -**Historical status:** read-only audit of the revision below, not a claim about current implementation. Subsequent S1/MR remediation is recorded in the [findings ledger](remediation/findings-ledger/README.md#page-overview); current user behavior is described in [Using CodexUI](../guides/interaction-guide.md#using-codexui). +**Historical status:** read-only audit of the revision below, not a claim about current implementation. Subsequent S1/MR remediation is recorded in the [findings ledger](remediation/findings-ledger/README.md#banner); current user behavior is described in [Using CodexUI](../guides/interaction-guide.md#using-codexui). **Audit date:** 2026-09-12 (Europe/Vienna) **Repository:** `/path/to/workspace/drafts/CodexUI/codexui` **Revision reviewed:** `629660e8882bddc7473ee5f1aab90c755ee6edd4` (`master`) plus the pre-existing uncommitted worktree recorded below. diff --git a/docs/architecture/qt-virtualized-conversation-view.md b/docs/architecture/qt-virtualized-conversation-view.md index 8b7cc3b..aebd5ec 100644 --- a/docs/architecture/qt-virtualized-conversation-view.md +++ b/docs/architecture/qt-virtualized-conversation-view.md @@ -1,7 +1,7 @@ - +

CodexUI — Architecture

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# Qt virtualized conversation view diff --git a/docs/architecture/remediation/README.md b/docs/architecture/remediation/README.md index a87d1f3..3327a1c 100644 --- a/docs/architecture/remediation/README.md +++ b/docs/architecture/remediation/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Remediation

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# Remediation @@ -11,6 +11,6 @@ The Qt architecture remediation: findings ledger and working prompt. ## Sections -- [CodexUI Qt architecture remediation thread prompt](thread-prompt.md#page-overview) -- [Findings ledger](findings-ledger/README.md#page-overview) +- [CodexUI Qt architecture remediation thread prompt](thread-prompt.md#banner) +- [Findings ledger](findings-ledger/README.md#banner) diff --git a/docs/architecture/remediation/findings-ledger/README.md b/docs/architecture/remediation/findings-ledger/README.md index 7d54d5e..66d0063 100644 --- a/docs/architecture/remediation/findings-ledger/README.md +++ b/docs/architecture/remediation/findings-ledger/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Findings ledger

-

Up to RemediationSNode.C organizationCodexUI repository

+

Up to RemediationVolker Christian accountSNode.C organizationCodexUI repository

# Findings ledger @@ -9,10 +9,10 @@ ## Sections -- [Qt architecture remediation findings ledger](current-repair-plan.md#page-overview) -- [Historical remediation and S1–S4 checkpoints](historical-record.md#page-overview) -- [S5 shared foundations and live conversation gates](s5-shared-foundations.md#page-overview) -- [S5 middle-region audit and MR-9 evidence](s5-middle-region-audit.md#page-overview) -- [S5 resumed-worktree and final S3 checkpoints](s5-resumed-worktree.md#page-overview) -- [Consolidated findings and external-review crosswalk](findings-and-crosswalk.md#page-overview) +- [Qt architecture remediation findings ledger](current-repair-plan.md#banner) +- [Historical remediation and S1–S4 checkpoints](historical-record.md#banner) +- [S5 shared foundations and live conversation gates](s5-shared-foundations.md#banner) +- [S5 middle-region audit and MR-9 evidence](s5-middle-region-audit.md#banner) +- [S5 resumed-worktree and final S3 checkpoints](s5-resumed-worktree.md#banner) +- [Consolidated findings and external-review crosswalk](findings-and-crosswalk.md#banner) diff --git a/docs/architecture/remediation/findings-ledger/current-repair-plan.md b/docs/architecture/remediation/findings-ledger/current-repair-plan.md index 51733fe..9ae3ad6 100644 --- a/docs/architecture/remediation/findings-ledger/current-repair-plan.md +++ b/docs/architecture/remediation/findings-ledger/current-repair-plan.md @@ -1,7 +1,7 @@ - +

CodexUI — Findings ledger

-

Up to Findings ledgerSNode.C organizationCodexUI repository

+

Up to Findings ledgerVolker Christian accountSNode.C organizationCodexUI repository

# Qt architecture remediation findings ledger diff --git a/docs/architecture/remediation/findings-ledger/findings-and-crosswalk.md b/docs/architecture/remediation/findings-ledger/findings-and-crosswalk.md index c156cea..aa8196c 100644 --- a/docs/architecture/remediation/findings-ledger/findings-and-crosswalk.md +++ b/docs/architecture/remediation/findings-ledger/findings-and-crosswalk.md @@ -1,7 +1,7 @@ - +

CodexUI — Findings ledger

-

Up to Findings ledgerSNode.C organizationCodexUI repository

+

Up to Findings ledgerVolker Christian accountSNode.C organizationCodexUI repository

# Consolidated findings and external-review crosswalk diff --git a/docs/architecture/remediation/findings-ledger/historical-record.md b/docs/architecture/remediation/findings-ledger/historical-record.md index d9aeb16..95ca86c 100644 --- a/docs/architecture/remediation/findings-ledger/historical-record.md +++ b/docs/architecture/remediation/findings-ledger/historical-record.md @@ -1,7 +1,7 @@ - +

CodexUI — Findings ledger

-

Up to Findings ledgerSNode.C organizationCodexUI repository

+

Up to Findings ledgerVolker Christian accountSNode.C organizationCodexUI repository

# Historical remediation and S1–S4 checkpoints diff --git a/docs/architecture/remediation/findings-ledger/s5-middle-region-audit.md b/docs/architecture/remediation/findings-ledger/s5-middle-region-audit.md index cc3d7bf..50ed637 100644 --- a/docs/architecture/remediation/findings-ledger/s5-middle-region-audit.md +++ b/docs/architecture/remediation/findings-ledger/s5-middle-region-audit.md @@ -1,7 +1,7 @@ - +

CodexUI — Findings ledger

-

Up to Findings ledgerSNode.C organizationCodexUI repository

+

Up to Findings ledgerVolker Christian accountSNode.C organizationCodexUI repository

# S5 middle-region audit and MR-9 evidence diff --git a/docs/architecture/remediation/findings-ledger/s5-resumed-worktree.md b/docs/architecture/remediation/findings-ledger/s5-resumed-worktree.md index b9ac61d..fc098c9 100644 --- a/docs/architecture/remediation/findings-ledger/s5-resumed-worktree.md +++ b/docs/architecture/remediation/findings-ledger/s5-resumed-worktree.md @@ -1,7 +1,7 @@ - +

CodexUI — Findings ledger

-

Up to Findings ledgerSNode.C organizationCodexUI repository

+

Up to Findings ledgerVolker Christian accountSNode.C organizationCodexUI repository

# S5 resumed-worktree and final S3 checkpoints diff --git a/docs/architecture/remediation/findings-ledger/s5-shared-foundations.md b/docs/architecture/remediation/findings-ledger/s5-shared-foundations.md index a887230..4b3db16 100644 --- a/docs/architecture/remediation/findings-ledger/s5-shared-foundations.md +++ b/docs/architecture/remediation/findings-ledger/s5-shared-foundations.md @@ -1,7 +1,7 @@ - +

CodexUI — Findings ledger

-

Up to Findings ledgerSNode.C organizationCodexUI repository

+

Up to Findings ledgerVolker Christian accountSNode.C organizationCodexUI repository

# S5 shared foundations and live conversation gates diff --git a/docs/architecture/remediation/thread-prompt.md b/docs/architecture/remediation/thread-prompt.md index fae9598..71857164 100644 --- a/docs/architecture/remediation/thread-prompt.md +++ b/docs/architecture/remediation/thread-prompt.md @@ -1,7 +1,7 @@ - +

CodexUI — Remediation

-

Up to RemediationSNode.C organizationCodexUI repository

+

Up to RemediationVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI Qt architecture remediation thread prompt diff --git a/docs/architecture/reviews/README.md b/docs/architecture/reviews/README.md index 7a78d2e..e5df6d1 100644 --- a/docs/architecture/reviews/README.md +++ b/docs/architecture/reviews/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Reviews

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# Reviews @@ -11,7 +11,7 @@ Historical external architecture reviews; findings refer to their captured revis ## Sections -- [External architecture review — ChatGPT](chatgpt.md#page-overview) -- [External architecture review — Claude A](claude-a.md#page-overview) -- [External architecture review — Claude B](claude-b.md#page-overview) +- [External architecture review — ChatGPT](chatgpt.md#banner) +- [External architecture review — Claude A](claude-a.md#banner) +- [External architecture review — Claude B](claude-b.md#banner) diff --git a/docs/architecture/reviews/chatgpt.md b/docs/architecture/reviews/chatgpt.md index bdf5965..5b3091f 100644 --- a/docs/architecture/reviews/chatgpt.md +++ b/docs/architecture/reviews/chatgpt.md @@ -1,7 +1,7 @@ - +

CodexUI — Reviews

-

Up to ReviewsSNode.C organizationCodexUI repository

+

Up to ReviewsVolker Christian accountSNode.C organizationCodexUI repository

# External architecture review — ChatGPT diff --git a/docs/architecture/reviews/claude-a.md b/docs/architecture/reviews/claude-a.md index cbadfe2..1f41667 100644 --- a/docs/architecture/reviews/claude-a.md +++ b/docs/architecture/reviews/claude-a.md @@ -1,7 +1,7 @@ - +

CodexUI — Reviews

-

Up to ReviewsSNode.C organizationCodexUI repository

+

Up to ReviewsVolker Christian accountSNode.C organizationCodexUI repository

# External architecture review — Claude A diff --git a/docs/architecture/reviews/claude-b.md b/docs/architecture/reviews/claude-b.md index 4047881..3dfd7a1 100644 --- a/docs/architecture/reviews/claude-b.md +++ b/docs/architecture/reviews/claude-b.md @@ -1,7 +1,7 @@ - +

CodexUI — Reviews

-

Up to ReviewsSNode.C organizationCodexUI repository

+

Up to ReviewsVolker Christian accountSNode.C organizationCodexUI repository

# External architecture review — Claude B diff --git a/docs/architecture/shared-node-graph.md b/docs/architecture/shared-node-graph.md index bfbb1db..00ba382 100644 --- a/docs/architecture/shared-node-graph.md +++ b/docs/architecture/shared-node-graph.md @@ -1,7 +1,7 @@ - +

CodexUI — Architecture

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# Shared node graph: writer, UI and projection readers @@ -288,7 +288,7 @@ is removed after cutover and is not retained as a fallback. ## Widget and UX compatibility contract The complete class, method, DTO, ordering, failure, and thread-affinity -contract is [`ui-ux-internal-api.md`](ui-internal-api.md#page-overview). The adapter and +contract is [`ui-ux-internal-api.md`](ui-internal-api.md#banner). The adapter and Shell integration are accepted only when they satisfy that contract as well as the visible behavior in `ui-behavior.md`. diff --git a/docs/architecture/timestamp-presentation.md b/docs/architecture/timestamp-presentation.md index 605d4d6..9f57261 100644 --- a/docs/architecture/timestamp-presentation.md +++ b/docs/architecture/timestamp-presentation.md @@ -1,7 +1,7 @@ - +

CodexUI — Architecture

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# App-server timestamp presentation @@ -85,4 +85,4 @@ Timestamp tests exercise units, missing values, lifecycle reconciliation, routin ## Implementation record -Historical verification and change accounting are kept in the [implementation record](../records/timestamp-verification.md#page-overview). Follow the current user guide above for behavior; historical test commands are not an onboarding requirement. +Historical verification and change accounting are kept in the [implementation record](../records/timestamp-verification.md#banner). Follow the current user guide above for behavior; historical test commands are not an onboarding requirement. diff --git a/docs/architecture/ui-internal-api.md b/docs/architecture/ui-internal-api.md index 5c77d74..adb00a8 100644 --- a/docs/architecture/ui-internal-api.md +++ b/docs/architecture/ui-internal-api.md @@ -1,7 +1,7 @@ - +

CodexUI — Architecture

-

Up to ArchitectureSNode.C organizationCodexUI repository

+

Up to ArchitectureVolker Christian accountSNode.C organizationCodexUI repository

# Native UI/UX internal API contract diff --git a/docs/guides/README.md b/docs/guides/README.md index 0fcb0d7..62b4a00 100644 --- a/docs/guides/README.md +++ b/docs/guides/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Guides

-

Up to DocumentationSNode.C organizationCodexUI repository

+

Up to DocumentationVolker Christian accountSNode.C organizationCodexUI repository

# Guides @@ -11,7 +11,7 @@ Building CodexUI and using its native interface. ## Sections -- [Build and install Codex(W)UI from source](build-from-source.md#page-overview) -- [Interaction guide](interaction-guide.md#page-overview) -- [Native thread projects and sections](thread-projects.md#page-overview) +- [Build and install Codex(W)UI from source](build-from-source.md#banner) +- [Interaction guide](interaction-guide.md#banner) +- [Native thread projects and sections](thread-projects.md#banner) diff --git a/docs/guides/build-from-source.md b/docs/guides/build-from-source.md index 7d35ddf..01db125 100644 --- a/docs/guides/build-from-source.md +++ b/docs/guides/build-from-source.md @@ -1,7 +1,7 @@ - +

CodexUI — Guides

-

Up to GuidesSNode.C organizationCodexUI repository

+

Up to GuidesVolker Christian accountSNode.C organizationCodexUI repository

# Build and install Codex(W)UI from source @@ -12,7 +12,7 @@ The native build requires a C++20 toolchain, CMake 3.20+, Ninja, Qt 6.6+ Widgets (the installed Qt version must satisfy that minimum), pkg-config, libgit2 development files, and compatible **SNode.C** and **AISuite** CMake installations. On Debian/Ubuntu, development packages include `libgit2-dev` and `qt6-base-dev` (plus your toolchain/build tools). Check the installed Qt version with `pkg-config --modversion Qt6Widgets`: the package name alone does not guarantee Qt 6.6+. Use a distribution/toolchain providing that minimum rather than bypassing CMake's check. -Build [SNode.C](https://github.com/SNodeC/snode.c#project-overview) and [AISuite](https://github.com/SNodeC/AISuite#project-overview) from their default branches. AISuite must export `AISuite::OpenAICodex`. Running the application also requires a configured Codex app-server through `codex-bridge`. +Build [SNode.C](https://github.com/SNodeC/snode.c#banner) and [AISuite](https://github.com/SNodeC/AISuite#banner) from their default branches. AISuite must export `AISuite::OpenAICodex`. Running the application also requires a configured Codex app-server through `codex-bridge`. ### Configure and build @@ -59,7 +59,7 @@ xvfb-run -a env QT_QPA_PLATFORM=offscreen \ The repository includes shared native/browser presentation fixtures, native interaction and geometry checks, and workload benchmarks. Selected native suites exercise DPR **1.0, 1.25, 1.5 and 2.0**. CI's accepted elapsed-time policy reports timing overruns; correctness and work-count checks remain enforced. -The [interactive qualification inventory](../qualification/native-test-suite.md#page-overview) defines the wider visual and UX acceptance scope. Its [execution record](../qualification/native-results-2026-09-27.md#page-overview) remains incomplete: a green CI run is not a claim of complete desktop, accessibility or hardware touchpad qualification. +The [interactive qualification inventory](../qualification/native-test-suite.md#banner) defines the wider visual and UX acceptance scope. Its [execution record](../qualification/native-results-2026-09-27.md#banner) remains incomplete: a green CI run is not a claim of complete desktop, accessibility or hardware touchpad qualification. ## Browser frontend @@ -90,7 +90,7 @@ npm ci --prefix web npm run release --prefix web ``` -The output is `web/app-dist/`. A combined install places it in `share/codexui/web`; the bridge can serve the application and `/codex` WebSocket from one listener. See [browser packaging and deployment](../../web/README.md#page-overview) for standalone installation and endpoint configuration. +The output is `web/app-dist/`. A combined install places it in `share/codexui/web`; the bridge can serve the application and `/codex` WebSocket from one listener. See [browser packaging and deployment](../../web/README.md#banner) for standalone installation and endpoint configuration. For native execution, return to [First run](../../README.md#first-run); qualification commands and coverage boundaries are in [Quality and development](#quality-and-development). diff --git a/docs/guides/interaction-guide.md b/docs/guides/interaction-guide.md index 37ca335..e7b15a9 100644 --- a/docs/guides/interaction-guide.md +++ b/docs/guides/interaction-guide.md @@ -1,7 +1,7 @@ - +

CodexUI — Guides

-

Up to GuidesSNode.C organizationCodexUI repository

+

Up to GuidesVolker Christian accountSNode.C organizationCodexUI repository

# Interaction guide @@ -19,13 +19,13 @@ Start with the [native or browser first run](../../README.md#first-run). This pa ## Known limitations - Approval dialogs check bounded transport shape and reject unsafe context, but do not provide full standard-MCP schema/content validation or file-change stale-revision gating. Agent approval/sandbox policy remains separate. Review untrusted tool requests and edits accordingly; see the [approval boundary record](../architecture/remediation/findings-ledger/findings-and-crosswalk.md#unresolved-evidence-questions-and-approval-gates). -- Native interactive qualification remains incomplete, not an approval of every UI path. The [qualification record](../qualification/native-results-2026-09-27.md#page-overview) records its environment and outstanding work. -- Dense emoji-heavy diffs were slow with the recorded stock Qt 6.10.2 build. An isolated patched-Qt experiment is not an installed fix or a promise for other Qt versions; the [performance record](../qualification/native-results-2026-09-27.md#page-overview) owns those measurements. +- Native interactive qualification remains incomplete, not an approval of every UI path. The [qualification record](../qualification/native-results-2026-09-27.md#banner) records its environment and outstanding work. +- Dense emoji-heavy diffs were slow with the recorded stock Qt 6.10.2 build. An isolated patched-Qt experiment is not an installed fix or a promise for other Qt versions; the [performance record](../qualification/native-results-2026-09-27.md#banner) owns those measurements. - Browser scope differs from native scope. Consult the [native-only 1.0 features](../web/contract-1.0.md#native-only-in-10) rather than assuming parity. ## Detailed native presentation contract -The [method-level internal API](../architecture/ui-internal-api.md#page-overview) owns the native logic/UI boundary. The specifications below describe the projection and interaction rules, not a prerequisite for first use. All Qt popup/context menus, including text-widget menus, use a compact white rounded surface, neutral border, 30-pixel actions, neutral hover, blue-tinted checked actions, muted disabled actions and inset separators. +The [method-level internal API](../architecture/ui-internal-api.md#banner) owns the native logic/UI boundary. The specifications below describe the projection and interaction rules, not a prerequisite for first use. All Qt popup/context menus, including text-widget menus, use a compact white rounded surface, neutral border, 30-pixel actions, neutral hover, blue-tinted checked actions, muted disabled actions and inset separators. ## Conversation source and structure diff --git a/docs/guides/thread-projects.md b/docs/guides/thread-projects.md index 6e5529f..8bc3971 100644 --- a/docs/guides/thread-projects.md +++ b/docs/guides/thread-projects.md @@ -1,7 +1,7 @@ - +

CodexUI — Guides

-

Up to GuidesSNode.C organizationCodexUI repository

+

Up to GuidesVolker Christian accountSNode.C organizationCodexUI repository

# Native thread projects and sections @@ -83,8 +83,8 @@ not retried repeatedly within that connection. ## Qualification boundary -These features are native-only. Offscreen/mock-backed checks do not establish real upstream project persistence, native-compositor behavior or screen-reader qualification. See the [qualification scope](../qualification/native-test-suite.md#page-overview) and historical execution evidence below. +These features are native-only. Offscreen/mock-backed checks do not establish real upstream project persistence, native-compositor behavior or screen-reader qualification. See the [qualification scope](../qualification/native-test-suite.md#banner) and historical execution evidence below. ## Implementation record -Historical verification and change accounting are kept in the [implementation record](../records/thread-projects-verification.md#page-overview). Follow the current user guide above for behavior; historical test commands are not an onboarding requirement. +Historical verification and change accounting are kept in the [implementation record](../records/thread-projects-verification.md#banner). Follow the current user guide above for behavior; historical test commands are not an onboarding requirement. diff --git a/docs/media/nav/account-dark.svg b/docs/media/nav/account-dark.svg new file mode 100644 index 0000000..3ae0841 --- /dev/null +++ b/docs/media/nav/account-dark.svg @@ -0,0 +1,22 @@ +Volker Christian accountVolker Christian diff --git a/docs/media/nav/account-icon-dark.svg b/docs/media/nav/account-icon-dark.svg new file mode 100644 index 0000000..a86e189 --- /dev/null +++ b/docs/media/nav/account-icon-dark.svg @@ -0,0 +1,22 @@ +Volker Christian account diff --git a/docs/media/nav/account-icon-light.svg b/docs/media/nav/account-icon-light.svg new file mode 100644 index 0000000..87f6230 --- /dev/null +++ b/docs/media/nav/account-icon-light.svg @@ -0,0 +1,22 @@ +Volker Christian account diff --git a/docs/media/nav/account-light.svg b/docs/media/nav/account-light.svg new file mode 100644 index 0000000..e2e6ee1 --- /dev/null +++ b/docs/media/nav/account-light.svg @@ -0,0 +1,22 @@ +Volker Christian accountVolker Christian diff --git a/docs/media/nav/organization-dark.svg b/docs/media/nav/organization-dark.svg index b7f440f..c0d96ad 100644 --- a/docs/media/nav/organization-dark.svg +++ b/docs/media/nav/organization-dark.svg @@ -19,4 +19,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -->Organization + -->SNode.C diff --git a/docs/media/nav/organization-light.svg b/docs/media/nav/organization-light.svg index b1f89a0..3462c04 100644 --- a/docs/media/nav/organization-light.svg +++ b/docs/media/nav/organization-light.svg @@ -19,4 +19,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -->Organization + -->SNode.C diff --git a/docs/media/nav/repository-dark.svg b/docs/media/nav/repository-dark.svg index b85a25f..7034e4a 100644 --- a/docs/media/nav/repository-dark.svg +++ b/docs/media/nav/repository-dark.svg @@ -19,4 +19,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -->Repository + -->CodexUI diff --git a/docs/media/nav/repository-light.svg b/docs/media/nav/repository-light.svg index a748cd5..542f3ec 100644 --- a/docs/media/nav/repository-light.svg +++ b/docs/media/nav/repository-light.svg @@ -19,4 +19,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -->Repository + -->CodexUI diff --git a/docs/media/nav/up-findings-ledger-dark.svg b/docs/media/nav/up-findings-ledger-dark.svg index e2a0937..6e436e5 100644 --- a/docs/media/nav/up-findings-ledger-dark.svg +++ b/docs/media/nav/up-findings-ledger-dark.svg @@ -1,4 +1,4 @@ -Up to Findings ledgerFindings ledger + -->Findings ledger diff --git a/docs/media/nav/up-findings-ledger-light.svg b/docs/media/nav/up-findings-ledger-light.svg index 65383a4..aca2200 100644 --- a/docs/media/nav/up-findings-ledger-light.svg +++ b/docs/media/nav/up-findings-ledger-light.svg @@ -1,4 +1,4 @@ -Up to Findings ledgerFindings ledger + -->Findings ledger diff --git a/docs/qualification/README.md b/docs/qualification/README.md index 79da3a2..f68f012 100644 --- a/docs/qualification/README.md +++ b/docs/qualification/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Qualification

-

Up to DocumentationSNode.C organizationCodexUI repository

+

Up to DocumentationVolker Christian accountSNode.C organizationCodexUI repository

# Qualification @@ -11,6 +11,6 @@ The native interactive test suite and its recorded execution results. ## Sections -- [Native qualification execution record — 2026-09-27](native-results-2026-09-27.md#page-overview) -- [CodexUI canonical interactive Xvfb test suite](native-test-suite.md#page-overview) +- [Native qualification execution record — 2026-09-27](native-results-2026-09-27.md#banner) +- [CodexUI canonical interactive Xvfb test suite](native-test-suite.md#banner) diff --git a/docs/qualification/native-results-2026-09-27.md b/docs/qualification/native-results-2026-09-27.md index 4c6272f..a9ce165 100644 --- a/docs/qualification/native-results-2026-09-27.md +++ b/docs/qualification/native-results-2026-09-27.md @@ -1,12 +1,12 @@ - +

CodexUI — Qualification

-

Up to QualificationSNode.C organizationCodexUI repository

+

Up to QualificationVolker Christian accountSNode.C organizationCodexUI repository

# Native qualification execution record — 2026-09-27 -Specification: [canonical interactive inventory and visual approval matrix](native-test-suite.md#page-overview). +Specification: [canonical interactive inventory and visual approval matrix](native-test-suite.md#banner). This records execution, not a replacement plan or reduced acceptance scope. **Overall verdict: incomplete, not approved.** The recorded repairs are verified diff --git a/docs/qualification/native-test-suite.md b/docs/qualification/native-test-suite.md index 4877967..d84f222 100644 --- a/docs/qualification/native-test-suite.md +++ b/docs/qualification/native-test-suite.md @@ -1,7 +1,7 @@ - +

CodexUI — Qualification

-

Up to QualificationSNode.C organizationCodexUI repository

+

Up to QualificationVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI canonical interactive Xvfb test suite @@ -522,7 +522,7 @@ The behavior inventory in sections 1–21 still applies in full. ### 22.9 Complete timestamp appearance inventory The schema inventory and formatter are authoritative: -[Timestamp presentation](../architecture/timestamp-presentation.md#page-overview), +[Timestamp presentation](../architecture/timestamp-presentation.md#banner), [protocol timing paths](../../src/codex/ProtocolTimingPaths.inc) and [TimingPresentation](../../src/codex/ui/TimingPresentation.cpp). These are supplied facts, not permission to fetch new APIs or invent times. diff --git a/docs/records/README.md b/docs/records/README.md index bb95972..125ec04 100644 --- a/docs/records/README.md +++ b/docs/records/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Records

-

Up to DocumentationSNode.C organizationCodexUI repository

+

Up to DocumentationVolker Christian accountSNode.C organizationCodexUI repository

# Records @@ -11,8 +11,8 @@ Verification records for individual features. ## Sections -- [Thread Projects Verification](thread-projects-verification.md#page-overview) -- [Timestamp Verification](timestamp-verification.md#page-overview) -- [Codex 0.162.1 migration inventory](codex-0.162.1-migration-inventory.md#page-overview) -- [Codex 0.162.1 local migration results](codex-0.162.1-migration-results.md#page-overview) +- [Thread Projects Verification](thread-projects-verification.md#banner) +- [Timestamp Verification](timestamp-verification.md#banner) +- [Codex 0.162.1 migration inventory](codex-0.162.1-migration-inventory.md#banner) +- [Codex 0.162.1 local migration results](codex-0.162.1-migration-results.md#banner) diff --git a/docs/records/codex-0.162.1-migration-inventory.md b/docs/records/codex-0.162.1-migration-inventory.md index 05111fc..ebf1b0c 100644 --- a/docs/records/codex-0.162.1-migration-inventory.md +++ b/docs/records/codex-0.162.1-migration-inventory.md @@ -1,12 +1,12 @@ - +

CodexUI — Records

-

Up to RecordsSNode.C organizationCodexUI repository

+

Up to RecordsVolker Christian accountSNode.C organizationCodexUI repository

# Codex 0.162.1 migration inventory -Inventory date: 2026-10-11. This records the analysis phase before the migration diff. At that point, neither repository's production code or tests had been edited. The subsequent authorized local implementation and its verification are recorded in [the implementation report](codex-0.162.1-migration-results.md). Experimental API access stays enabled. No system-wide Codex was installed, and production CODEX_HOME/database/authentication were not used for runtime testing. +Inventory date: 2026-10-11. This records the analysis phase before the migration diff. At that point, neither repository's production code or tests had been edited. The subsequent authorized local implementation and its verification are recorded in [the implementation report](codex-0.162.1-migration-results.md#banner). Experimental API access stays enabled. No system-wide Codex was installed, and production CODEX_HOME/database/authentication were not used for runtime testing. ## Versions and authority diff --git a/docs/records/codex-0.162.1-migration-results.md b/docs/records/codex-0.162.1-migration-results.md index a2a79f3..1e09fb0 100644 --- a/docs/records/codex-0.162.1-migration-results.md +++ b/docs/records/codex-0.162.1-migration-results.md @@ -1,14 +1,14 @@ - +

CodexUI — Records

-

Up to RecordsSNode.C organizationCodexUI repository

+

Up to RecordsVolker Christian accountSNode.C organizationCodexUI repository

# Codex 0.162.1 local migration results Date: 2026-10-11. The migration is implemented locally in CodexUI and AISuite. This report records the local implementation and verification before publication. Experimental API access remains enabled. No system-wide Codex installation, personal-service restart, production Codex-home access, credential copy or production database migration was performed. Runtime qualification used the complete localized release package, disposable homes/configuration/workspaces and loopback mock model providers. -The [migration inventory](codex-0.162.1-migration-inventory.md) records the decisions, complete schema delta, experimental usage, persistence/package requirements and answers to the preceding questions. This report records the resulting implementation and its verification. It does not claim production deployment or complete acceptance of the canonical [22-section native interactive and visual suite](../qualification/native-test-suite.md). +The [migration inventory](codex-0.162.1-migration-inventory.md#banner) records the decisions, complete schema delta, experimental usage, persistence/package requirements and answers to the preceding questions. This report records the resulting implementation and its verification. It does not claim production deployment or complete acceptance of the canonical [22-section native interactive and visual suite](../qualification/native-test-suite.md#banner). AISuite dependency: commit [`a913b80228e5a8320517cd989043ad3d6e6ad73b`](https://github.com/SNodeC/AISuite/commit/a913b80228e5a8320517cd989043ad3d6e6ad73b). Build and stage that SDK before rebuilding either CodexUI frontend. diff --git a/docs/records/thread-projects-verification.md b/docs/records/thread-projects-verification.md index e89acb2..a6dcf0b 100644 --- a/docs/records/thread-projects-verification.md +++ b/docs/records/thread-projects-verification.md @@ -1,7 +1,7 @@ - +

CodexUI — Records

-

Up to RecordsSNode.C organizationCodexUI repository

+

Up to RecordsVolker Christian accountSNode.C organizationCodexUI repository

# Thread Projects Verification @@ -189,7 +189,7 @@ store. Upstream persistence and native-compositor qualification remain unclaimed ## 2026-10-12: local draft placement -Verification baseline: `9a84371b6d4a8e2504065d89b1b080d5ff0b7df1`; local working-tree fix, Debug, Qt 6.11.2. This is targeted qualification for local draft grouping and promotion, not a complete execution of the [canonical native interactive suite](../qualification/native-test-suite.md). No installed applications, personal services or production Codex data were changed. +Verification baseline: `9a84371b6d4a8e2504065d89b1b080d5ff0b7df1`; local working-tree fix, Debug, Qt 6.11.2. This is targeted qualification for local draft grouping and promotion, not a complete execution of the [canonical native interactive suite](../qualification/native-test-suite.md#banner). No installed applications, personal services or production Codex data were changed. Invariant: the intended project/section determines placement from the local draft through worker admission; a confirmed thread then uses server-owned membership. The complete renderer-local draft row is fed through the existing NodeGraphUiAdapter grouping projection. Correlated graph rows supersede that input within the existing traversal. The worker relates admitted local threads to existing group entities; it does not manufacture group entities or override confirmed server membership. The forced top-level placement and duplicated creation/recovery setup were removed. No new timer, cache, persistent flag, renderer or wire API was introduced. diff --git a/docs/records/timestamp-verification.md b/docs/records/timestamp-verification.md index 545d23c..d414500 100644 --- a/docs/records/timestamp-verification.md +++ b/docs/records/timestamp-verification.md @@ -1,7 +1,7 @@ - +

CodexUI — Records

-

Up to RecordsSNode.C organizationCodexUI repository

+

Up to RecordsVolker Christian accountSNode.C organizationCodexUI repository

# Timestamp Verification diff --git a/docs/ui-review/README.md b/docs/ui-review/README.md index 30c037a..408fd9e 100644 --- a/docs/ui-review/README.md +++ b/docs/ui-review/README.md @@ -1,7 +1,7 @@ - +

CodexUI — UI review

-

Up to DocumentationSNode.C organizationCodexUI repository

+

Up to DocumentationVolker Christian accountSNode.C organizationCodexUI repository

# UI review @@ -11,9 +11,9 @@ UI review material: inventory, state matrix, UX decisions and the code-polish ro ## Sections -- [CodexUI code-polish roadmap](code-polish-roadmap.md#page-overview) -- [CodexUI Current Interaction State Matrix](state-matrix.md#page-overview) -- [CodexUI UX Decision: Threads, Turns, and Prompt Admission](thread-turn-model.md#page-overview) -- [CodexUI Current UI Inventory](ui-inventory.md#page-overview) -- [CodexUI UI/UX Decisions](ux-decisions.md#page-overview) +- [CodexUI code-polish roadmap](code-polish-roadmap.md#banner) +- [CodexUI Current Interaction State Matrix](state-matrix.md#banner) +- [CodexUI UX Decision: Threads, Turns, and Prompt Admission](thread-turn-model.md#banner) +- [CodexUI Current UI Inventory](ui-inventory.md#banner) +- [CodexUI UI/UX Decisions](ux-decisions.md#banner) diff --git a/docs/ui-review/code-polish-roadmap.md b/docs/ui-review/code-polish-roadmap.md index 0233b1d..a974f15 100644 --- a/docs/ui-review/code-polish-roadmap.md +++ b/docs/ui-review/code-polish-roadmap.md @@ -1,7 +1,7 @@ - +

CodexUI — UI review

-

Up to UI reviewSNode.C organizationCodexUI repository

+

Up to UI reviewVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI code-polish roadmap diff --git a/docs/ui-review/state-matrix.md b/docs/ui-review/state-matrix.md index 7475659..1a0754f 100644 --- a/docs/ui-review/state-matrix.md +++ b/docs/ui-review/state-matrix.md @@ -1,7 +1,7 @@ - +

CodexUI — UI review

-

Up to UI reviewSNode.C organizationCodexUI repository

+

Up to UI reviewVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI Current Interaction State Matrix diff --git a/docs/ui-review/thread-turn-model.md b/docs/ui-review/thread-turn-model.md index b183ed5..a5c1296 100644 --- a/docs/ui-review/thread-turn-model.md +++ b/docs/ui-review/thread-turn-model.md @@ -1,7 +1,7 @@ - +

CodexUI — UI review

-

Up to UI reviewSNode.C organizationCodexUI repository

+

Up to UI reviewVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI UX Decision: Threads, Turns, and Prompt Admission diff --git a/docs/ui-review/ui-inventory.md b/docs/ui-review/ui-inventory.md index 1e4b0b1..2659d2a 100644 --- a/docs/ui-review/ui-inventory.md +++ b/docs/ui-review/ui-inventory.md @@ -1,12 +1,12 @@ - +

CodexUI — UI review

-

Up to UI reviewSNode.C organizationCodexUI repository

+

Up to UI reviewVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI Current UI Inventory -This is a historical UI inventory. Its measured-placeholder and request-acknowledgment descriptions are superseded by [current user behavior](../guides/interaction-guide.md#using-codexui) and the [remediation record](../architecture/remediation/findings-ledger/README.md#page-overview), not a current acceptance claim. +This is a historical UI inventory. Its measured-placeholder and request-acknowledgment descriptions are superseded by [current user behavior](../guides/interaction-guide.md#using-codexui) and the [remediation record](../architecture/remediation/findings-ledger/README.md#banner), not a current acceptance claim. ## Top bar diff --git a/docs/ui-review/ux-decisions.md b/docs/ui-review/ux-decisions.md index 1d35111..25a1e28 100644 --- a/docs/ui-review/ux-decisions.md +++ b/docs/ui-review/ux-decisions.md @@ -1,12 +1,12 @@ - +

CodexUI — UI review

-

Up to UI reviewSNode.C organizationCodexUI repository

+

Up to UI reviewVolker Christian accountSNode.C organizationCodexUI repository

# CodexUI UI/UX Decisions -This engineering decision record predates some current presentation changes. For current user-facing status/color behavior, use [UI behavior](../guides/interaction-guide.md#page-overview); historical wording such as neutral interim updates does not override that guide. +This engineering decision record predates some current presentation changes. For current user-facing status/color behavior, use [UI behavior](../guides/interaction-guide.md#banner); historical wording such as neutral interim updates does not override that guide. ## Visual system diff --git a/docs/web/README.md b/docs/web/README.md index 9089b5f..6eb788b 100644 --- a/docs/web/README.md +++ b/docs/web/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Web UI

-

Up to DocumentationSNode.C organizationCodexUI repository

+

Up to DocumentationVolker Christian accountSNode.C organizationCodexUI repository

# Web UI @@ -11,7 +11,7 @@ The CodexWebUI 1.0 contract, its qualification and the release-candidate process ## Sections -- [CodexWebUI 1.0 Contract](contract-1.0.md#page-overview) -- [CodexWebUI qualification](qualification.md#page-overview) -- [CodexWebUI release-candidate process](release-process.md#page-overview) +- [CodexWebUI 1.0 Contract](contract-1.0.md#banner) +- [CodexWebUI qualification](qualification.md#banner) +- [CodexWebUI release-candidate process](release-process.md#banner) diff --git a/docs/web/contract-1.0.md b/docs/web/contract-1.0.md index 693c9d0..3a4b40c 100644 --- a/docs/web/contract-1.0.md +++ b/docs/web/contract-1.0.md @@ -1,7 +1,7 @@ - +

CodexUI — Web UI

-

Up to Web UISNode.C organizationCodexUI repository

+

Up to Web UIVolker Christian accountSNode.C organizationCodexUI repository

# CodexWebUI 1.0 Contract diff --git a/docs/web/qualification.md b/docs/web/qualification.md index 036135a..e586995 100644 --- a/docs/web/qualification.md +++ b/docs/web/qualification.md @@ -1,13 +1,13 @@ - +

CodexUI — Web UI

-

Up to Web UISNode.C organizationCodexUI repository

+

Up to Web UIVolker Christian accountSNode.C organizationCodexUI repository

# CodexWebUI qualification This record qualifies the browser frontend against -[the web 1.0 contract](contract-1.0.md#page-overview). Cross-frontend agreement is +[the web 1.0 contract](contract-1.0.md#banner). Cross-frontend agreement is evidence-backed only where the same fixture corpus is executed by native C++ and browser TypeScript. The other suites are browser-local regression evidence; they neither execute Qt nor claim pixel identity with it. @@ -160,7 +160,7 @@ Timing runs were serial and separate from builds/tests; all execution checks used `xvfb-run -a env QT_QPA_PLATFORM=offscreen`. The production artifact was rebuilt and its relocatability verified. Intermediate failures, source/LOC accounting, exact commands and qualification limitations are retained in the -[remediation ledger](../architecture/remediation/findings-ledger/README.md#page-overview). +[remediation ledger](../architecture/remediation/findings-ledger/README.md#banner). This is local-worktree evidence, not a claim of universally lag-free operation; the AISuite source change must accompany CodexUI in subsequent releases. diff --git a/docs/web/release-process.md b/docs/web/release-process.md index cc4003e..a742b81 100644 --- a/docs/web/release-process.md +++ b/docs/web/release-process.md @@ -1,7 +1,7 @@ - +

CodexUI — Web UI

-

Up to Web UISNode.C organizationCodexUI repository

+

Up to Web UIVolker Christian accountSNode.C organizationCodexUI repository

# CodexWebUI release-candidate process diff --git a/web/README.md b/web/README.md index c8cb619..0aa48f8 100644 --- a/web/README.md +++ b/web/README.md @@ -1,7 +1,7 @@ - +

CodexUI — Web UI

-

Up to CodexUISNode.C organizationCodexUI repository

+

Up to CodexUIVolker Christian accountSNode.C organizationCodexUI repository

# CodexWUI @@ -55,4 +55,4 @@ Verify page/assets delivery, the WSS handshake, controller/observer behavior and - `npm run verify:artifact` proves that the output is non-empty and relocatable below an arbitrary static base path. - The web qualification job checks the SDK from AISuite's default branch independently, runs the web suite, records the performance profile, installs the artifact through CMake, and uploads the verified staged tree as `codexui-web`. -The authoritative scope and exceptions are in [`../docs/web/contract-1.0.md`](../docs/web/contract-1.0.md#page-overview). +The authoritative scope and exceptions are in [`../docs/web/contract-1.0.md`](../docs/web/contract-1.0.md#banner).