Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
91b780b
docs: define Task 3C mobile-first provider contracts (#137)
adrianwebb Oct 25, 2026
429c793
docs: map Admin routes and actions to reusable UI presentation (#137)
adrianwebb Oct 25, 2026
6114627
docs: pin owner artifact adoption before Admin presentation (#137)
adrianwebb Oct 25, 2026
9ff80a9
build: adopt exact SDK Identity and UI owner archives (#137)
adrianwebb Oct 25, 2026
917152b
Merge branch 'feature/137-task3c-artifacts' into feature/137-task3c-ui
adrianwebb Oct 25, 2026
61ab88f
test: specify default Admin UI browser and authority boundaries (#137)
adrianwebb Oct 25, 2026
441b1a0
fix: consume qualified UI lease isolation archive (#137)
adrianwebb Oct 25, 2026
8f518cf
Merge branch 'feature/137-task3c-artifacts' into feature/137-task3c-ui
adrianwebb Oct 25, 2026
1b4f438
docs: bind Admin hydration to verified public asset closure (#137)
adrianwebb Oct 25, 2026
5ba0cf8
fix: refresh locked UI archive integrity after qualification (#137)
adrianwebb Oct 25, 2026
222f9c1
Merge branch 'feature/137-task3c-artifacts' into feature/137-task3c-ui
adrianwebb Oct 25, 2026
7c4b7d1
test: verify Admin asset integrity and browser authority refusals (#137)
adrianwebb Oct 25, 2026
0c5e0a1
feat: render installed Admin through native reusable UI providers (#137)
adrianwebb Oct 25, 2026
9afdc9c
chore: inherit reusable Admin UI candidate (#137)
adrianwebb Oct 25, 2026
037cf7a
docs: qualify Admin against exact current owner archives (#137)
adrianwebb Oct 25, 2026
439d638
chore: qualify Admin with exact current owner archives (#137)
adrianwebb Oct 25, 2026
c14c47f
docs: adopt selected identity endpoint without moving authority (#137)
adrianwebb Oct 25, 2026
957f5ff
chore: consume exact selected-endpoint identity and rebuild Admin ass…
adrianwebb Oct 25, 2026
64247e7
docs: require installed dependency read-back for this adoption (#137)
adrianwebb Oct 25, 2026
82ad51f
test: reject stale installed owner identities during archive adoption…
adrianwebb Oct 25, 2026
e3155dc
fix: refresh exact installed identity before Admin acceptance (#137)
adrianwebb Oct 25, 2026
fc63e5a
docs(admin): define Node package-root asset resolution (#137)
adrianwebb Oct 25, 2026
1f70baa
test(admin): reproduce built Node asset catalog failure (#137)
adrianwebb Oct 25, 2026
45abbee
fix(admin): resolve matching npm root for Node assets (#137)
adrianwebb Oct 25, 2026
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
7 changes: 5 additions & 2 deletions .github/workflows/verify.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ permissions:
contents: read
jobs:
verify:
runs-on: ubuntu-24.04
runs-on: ubuntu-26.04
timeout-minutes: 10
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
Expand All @@ -18,5 +18,8 @@ jobs:
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
with:
node-version: 24.19.0
- run: bun install --frozen-lockfile
- run: bun install --frozen-lockfile --ignore-scripts
- run: sudo apt-get update
- run: sudo apt-get install -y libnss3-tools
- run: bun node_modules/playwright/cli.js install --with-deps firefox
- run: bun run verify
14 changes: 14 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,20 @@

## [Unreleased]

### Fixed
- Resolve Node asset dependencies across nested module-mode boundaries (#137).

### Changed
- Adopt selected-endpoint Identity contracts while retaining reusable UI and session ownership (#137).

### Changed
- Qualify Admin presentation with exact SDK .12 UI .14 and Identity .3 archives (#137).

- Render installed Admin through reusable UI providers while retaining Keycloak session boundaries (#137).
- Align exact shared SDK Identity and UI artifacts for reusable presentation (#137).

### Added

- Admin: deliver Task 3C typed providers and mobile-first UI integration (#137).

- Add identity-backed installed administration plugins (#135).
63 changes: 63 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,66 @@ Task 3B is authorized after the maintainer reviewed the isolated setup. Tracking
Development: Bun 1.4.4, Node 24.19.0, TypeScript 5.9.3, native Cordis 4.0.0-rc.12. Run bun run verify (semantic class/source check, strict compiler, build and nonempty unit/integration/program smoke). Installed acceptance uses genuine exact package/OCI bytes, real identity/database/API/HTTPS and explicit isolated certificate trust. No global trust mutation or legacy service changes. All handwritten source, tools and tests are strict TypeScript classes.

All capabilities that can be plugins, including container services, are native Cordis class plugins with typed swappable contracts. No parallel DI graph. Keep independent repository/public package boundaries, exact archive pins and original licenses. Migration PRs target cordis with Part of issue references. All issues remain open until authorized release; installer/Agent/generalized recovery are later tasks.

## Task 3C contract

Owner issue: https://github.com/treeseed-ai/admin/issues/137. Follow the approved Platform Task 3C service/provider/UI plan through exact public archives. Preserve independent repository ownership, strict TypeScript classes, native Cordis lifecycle, historical formats and all seven SDK operations. Expected-generation/idempotency, resource/credential/TLS retention and explicit unsafe restart/migration gates are mandatory. All issues remain open until release.

Every visual component must be mobile-first from 320 CSS pixels to widescreen monitors; test 320/375/768/1024/1440/1920/2560 widths, long content, keyboard/touch and 200% text resizing. Keep authored controls at least 44×44 CSS pixels, required actions visible, logical/fluid dimensions and no page overflow (labeled local semantic-table overflow is permitted). UI owns components/styles/renderers; consumers retain domain behavior and Identity retains Keycloak authority.

## Reusable UI presentation boundary

Admin maps installed status and sign-out into validated UI stack/status/table/form models.
UI owns the complete mobile-first document, controls, styles, inert bootstrap and browser
hydration. Admin owns its routes, same-origin status/logout request adapters, cookie/session
boundaries and navigation. Keycloak login/callback/PKCE and issuer/session authority remain
in Identity. No bearer tokens, session cookies or client secrets enter browser/bootstrap data.

The sign-out action carries only its public session-bound anti-CSRF nonce through typed
`actionData`; the existing server origin/nonce checks remain authoritative. Browser status
uses the existing authenticated `/admin/status` interface. Immutable browser/style assets
are served from verified owner bytes under the same-origin CSP, including `style-src 'self'`.
Native route/browser adapters remain swappable class providers. UI artifacts and all runtime
peers are selected by exact public package archives; no owner source import is introduced.
### Exact owner artifact adoption

The current Task 3C dependency candidate aligns SDK `.12`, Identity `.4` and UI `.14` through exact
vendored public archives and peer pins. Admin constructs domain view models and delegates human
rendering to UI providers. Native session/route and browser-only asset checks remain required;
dependency qualification alone does not establish the genuine Keycloak installed assembly gate.

Browser qualification uses exact Playwright 1.64.1 and a fresh Firefox/NSS profile with explicit
fixture certificate trust. Ubuntu 26.04 CI installs visible prerequisites; no global trust
change or ignored TLS failure is part of the acceptance gate.

`GET /admin/presentation` is a session-protected, no-store human-interface bootstrap adapter
returning only the accepted public asset generation. The browser compares it through UI's
hydration contract before admitting actions. The server verifies its complete installed public
asset closure (package identity, path, bytes and digest), serves immutable same-origin assets,
and refuses a configured asset generation that differs from those actual bytes. Status refresh
uses the existing protected endpoint; logout drains UI actions before navigating to Keycloak's
existing login flow. These adapters add no installer or machine-operation endpoint.

The selected-endpoint continuation adopts Identity `.4` from
`d837d23d99bc49eb1954bdd865397d34186d41a1`, archive SHA-256
`0e377e4a0ad79ee649b20e41779c862e431f20979b19cae638b658925686d9f1`.
This removes the inherited fixed internal identity name/port in the owning adapter. Admin
continues to consume Identity's native session contract and UI `.14` public renderers; it does
not take ownership of OIDC or introduce another authority. Rebuild and qualify the browser
asset/package identity together. Genuine installed Keycloak acceptance remains in the API and
Platform assembled gates; authority fixtures in this repository are still explicitly fixtures.

The adoption smoke checks installed SDK/UI/Identity versions against exact peer selections and
vendored archive hashes before accepting the candidate. Changed local tarball specifiers require
a forced fresh install; changing a cache directory alone can leave previous installed bytes.
The corrected Admin `.6` candidate is rebuilt and reverified after that read-back. Older private
candidate receipts remain historical; they do not stand in for this installed dependency check.

### Node package-boundary asset resolution

The default asset catalog must resolve every dependency to its matching named npm package
root. A nested `package.json` that only declares module mode is not a package identity; Node
may legitimately resolve a CommonJS export beneath that boundary (including Postgres).
Keep package names, versions, complete dependency traversal and asset-byte checks authoritative.
The built Node default-construction smoke runs with genuine installed dependencies, without
substituting an asset provider or requiring database or identity services.
35 changes: 31 additions & 4 deletions bun.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading