Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 18 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,9 @@ All notable changes to DirXMLDevWeb are documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]
## [0.75.0] - 2026-10-23

Needs DirXMLDev 0.50.0.

### Changed

Expand All @@ -16,6 +18,16 @@ and this project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
behaviour). An existing `audit.log` larger than the limit is rotated on the first line after the
upgrade; nothing is deleted then. The Audit view reads the files newest first, from their ends,
and stops as soon as it has its lines, instead of reading the whole log for every request.
- **Docs brought up to date.**
- pull-requests.md and multi-user.md are user references now, not design notes, each with its
API fields.
- data-model.md has people's own connections, Git and agent tokens, sessions, the overrides
file's names, servers and jobs, and known differences.
- design.md is marked historical (W7 built; rollback, secrets and driver deletion are on the
page), and connections-ui.md says it is built.
- limits.md gives the trace view's real buffer (50,000 records, 15,000 shown, adjustable), and
development.md the release steps as they are.
- hosted-install.md no longer describes Point Blue's own lab.

### Fixed

Expand All @@ -25,6 +37,11 @@ and this project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html)

### Removed

- **Design notes for features that are built:** docs/architecture-view.md, docs/trace-viewer.md,
docs/simple-install.md and docs/event-logger.md. What they describe is in features.md,
quickstart.md and upgrading.md; the two event-logger steps still to build are issues #164 (the
logger as a catalog package) and #165 (`pbt-eventlog.js`, capture samples at a stage). Git
history keeps the notes.
- docs/hosted.md, the hosted-mode design note of 2026-10-05: its body described the design before it
was built (one shared vault bind, compare-page pull requests, no merging on the page, decisions
still open), and hosted-mode.md, hosted-install.md, security.md, multi-user.md,
Expand Down
10 changes: 4 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,18 +137,16 @@ for developing it or for a quick look at a tree. Upgrading an install is running
| [docs/features.md](docs/features.md) | every view, by area |
| [docs/agents.md](docs/agents.md) | agents: tokens, connecting Claude Code or Cursor, the setup prompt, every MCP tool and its arguments, the CLIs, the agent kit |
| [docs/data-model.md](docs/data-model.md) | projects, workspaces, trees, environments and vaults: the entity relationship diagram |
| [docs/multi-user.md](docs/multi-user.md) | design note: per-user connections, data and traces on a hosted server |
| [docs/architecture-view.md](docs/architecture-view.md) | design note: the Architecture (Designer Modeler) and Developer views |
| [docs/multi-user.md](docs/multi-user.md) | what's yours and what's shared on a hosted server: vault sign-ins, tokens, traces, the files they live in |
| [docs/pull-requests.md](docs/pull-requests.md) | pull requests from the page: providers, whose account, the workstation's `gh` / `glab`, the API |
| [docs/hosted-install.md](docs/hosted-install.md) | the container for a team: image, host layout, proxy, Keycloak, the lab |
| [docs/hosted-mode.md](docs/hosted-mode.md) | hosted configuration: projects, repositories, identity (`token`, `oidc`, `none`), roles, agents |
| [docs/security.md](docs/security.md) | what the server refuses, where credentials live, what never leaves it; how the workstation and hosted modes differ |
| [docs/secret-managers.md](docs/secret-managers.md) | AWS, Azure, GCP, CyberArk, BeyondTrust, Bitwarden, Terraform: a credential as a command |
| [docs/development.md](docs/development.md) | running from a checkout, layout, tests, releasing |
| [docs/limits.md](docs/limits.md) | what still goes through Operations or the CLI |
| [docs/design.md](docs/design.md) | the assessment and the phases |
| [docs/event-logger.md](docs/event-logger.md) | design note: the Event Logger integration: events as simulator cases, an Events view, the logger as a package |
| [docs/connections-ui.md](docs/connections-ui.md) | design note: the Connections page: one flow per vault (address, certificate, sign-in, driver set), required before optional, certificate pinning, rotated passwords made obvious and easy |
| [docs/trace-viewer.md](docs/trace-viewer.md) | design note: the DirXML Trace Viewer in the workbench: a shared trace library, live and file trace with colours, filters, find and links into the tree |
| [docs/design.md](docs/design.md) | historical: the assessment and phases from before it was built, and why it is built this way |
| [docs/connections-ui.md](docs/connections-ui.md) | design note (built in 0.61.0): the Connections page, and the layout rules every form follows: required before optional, one status and one action per row, rotated passwords made obvious |
| [CHANGELOG.md](CHANGELOG.md) | every release |

## License
Expand Down
2 changes: 1 addition & 1 deletion bin/smoke-hosted.sh
Original file line number Diff line number Diff line change
Expand Up @@ -445,7 +445,7 @@ check("her agent's calls are hers, marked via its token", any(l["user"] == "alic
and any(l["user"] == "alice" and l["event"] == "agent-token-create" for l in lines) and all(made["token"] not in json.dumps(l) for l in lines))
print("smoke-hosted: all passed")
PY
# the local install's `setup` (docs/simple-install.md), written into a temporary folder
# the local install's `setup` (docs/quickstart.md), written into a temporary folder
mkdir -p "$WORK/setup"
"$HERE/bin/idmweb" setup --dir "$WORK/setup" --port 18099 --user smoke > "$WORK/setup.out" 2>&1 || { cat "$WORK/setup.out"; echo "FAIL setup"; exit 1; }
if grep -q "container_name: idmweb" "$WORK/setup/compose.yml" && grep -q "^IDMWEB_TOKEN=" "$WORK/setup/idmweb.env" \
Expand Down
163 changes: 0 additions & 163 deletions docs/architecture-view.md

This file was deleted.

5 changes: 5 additions & 0 deletions docs/connections-ui.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# Design note: the Connections page

Status: **built** in DirXMLDevWeb 0.61.0 with DirXMLDev 0.43.0 (the page, certificate pinning,
rotated passwords, servers, the project's repository); #131 closed. The rules in *Rules the layout
follows* and *Words* still hold for any form added to the page. What the page does now is in
[features.md](features.md) (Connections, Projects) and [multi-user.md](multi-user.md).

Issue #131. This note covers how the Connections page should look and behave, and the one core
change it needs: trusting a vault's certificate by its fingerprint instead of accepting any
certificate. What stays the same:
Expand Down
Loading
Loading