Skip to content

Develop - #102

Merged
Nexus-ABC merged 10 commits into
mainfrom
develop
Aug 3, 2026
Merged

Develop#102
Nexus-ABC merged 10 commits into
mainfrom
develop

Conversation

@Nexus-ABC

Copy link
Copy Markdown
Contributor

What this change does

Why

Pre-edit reading (3-doc rule)

  • I read the architecture doc(s) listed in docs/developers/architecture/README.md for the area I changedwhich doc(s)?:
  • I read the matching feature doc under docs/users/features/ if this change touches a user-visible surface — which doc?:
  • I read docs/developers/workflow/conventions.md (code style).

If a row for your edit area didn't exist in the trigger map, that itself is a signal — either an undocumented subsystem or a new one that needs its own arch doc.

Workflow

  • Plan + Todo were live before code (Cursor TodoWrite or Claude Code TaskCreate).
  • No code-level TODO / FIXME / XXX / unimplemented / not implemented / stub / mock strings in production code (test mocks are fine).
  • English only for committed text (docs, comments, commit messages, READMEs, config-doc strings).
  • All my commits use explicit pathspec so no other session's WIP got swept in.

High-blast-radius surfaces — check if your change touches any

  • macOS NE provider (packages/agent/platform/darwin/NexusAgent/NexusAgentExtension/**) — I respected the fail-open invariants listed in CLAUDE.md.
  • Admin API endpoint / sidebar / route changes — I ran the IAM impact review and updated seed.ts + iam/managed.go if I introduced a new resource.
  • Provider adapter / format translator — my change conforms to the 7-rule contract in docs/developers/architecture/services/ai-gateway/provider-adapter-architecture.md §3a (run /adapter-conformance-check if uncertain).
  • packages/shared/** — additive-only public API change.
  • Prisma migration — the timestamp prefix is unique (no two folders share YYYYMMDDHHMMSS).

Tests + CI

  • go test -race -count=1 passes for every module I touched.
  • Each new Go package has ≥95% statement coverage (or an entry in scripts/.coverage-allowlist with a category rationale).
  • npm run check:all passes (i18n parity + design tokens + arch-doc triggers + jobs-catalogue lockstep + …).
  • If I added a new architecture doc, I also added the matching row to docs/developers/architecture/README.md (pre-commit lockstep guard checks).

Commit hygiene

  • Commit message follows the repo's <type>(<scope>): <summary> pattern (feat / fix / refactor / docs / chore / test).
  • No co-author trailers from prior sessions accidentally carried over.

Nexus-ABC and others added 10 commits August 3, 2026 15:00
…nc 12)

Bring repository-level assets up to date.

- Documentation: README, CLAUDE.md, CHANGELOG; the docs/ tree (developers,
  operators, users) including the DB migration mechanics architecture, which now
  documents that schema-extras.sql applies all-or-nothing and must fail loudly
- Build & lint config: docker-compose.yml, .gitignore, .env.example
- Developer tooling: scripts/, tools/, examples/, .githooks, .cursor rules,
  .claude/skills; tools/db-migrate gains a precondition script that clears
  superseded duplicate agent fingerprints before the extras apply
- CI: .github/workflows

The README CI badges now point at this repository's own Actions runs rather than
a repository the public audience cannot see.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…ain (sync 12)

Backend service implementations and shared Go libraries:

- packages/ai-gateway: ingress proxy, provider adapters, canonical bridge,
  cache, normalize
- packages/shared: Go shared libraries (transport, traffic, policy, storage,
  schemas, identity, audit, core)
- packages/control-plane: admin API, analytics store, fleet and agent audit,
  identity provider surface
- packages/nexus-hub: hub service, jobs, alerts, observability consumers
- packages/compliance-proxy: compliance pipeline
- packages/agent: endpoint agent (darwin/linux/windows)
- go.work: workspace member set

Runtime artifacts (logs/, dev-certs/) intentionally excluded.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…c 12)

Frontend code, JS dependencies, and repository-level test suites:

- packages/control-plane-ui: React control plane
- packages/ui-shared: shared UI primitives and theme/chart utilities
- package.json + package-lock.json refresh
- tests/: integration-go, e2e-python, e2e-ui, smoke, agent, scenarios, manual,
  lib, scripts (package-internal tests ship with the backend PR)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Container build and self-hosted deployment assets, new to this repository:

- docker/: per-service Dockerfiles, a shared build base, the control-plane-ui
  image, and the db-migrator image whose entrypoint applies the schema, the
  PostgreSQL-native schema extras and the seed in order, failing the run if any
  step fails
- deploy/: compose stack, nginx site config, prometheus scrape config, systemd
  units for the four services, secrets bootstrap script and .env.example

Every service in the compose stack gates on the db-migrator completing
successfully, so a database that is not fully migrated cannot serve traffic.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
- packages/nexus-agent-core: the resource catalog engine (catalog, search,
  distill, cards) plus the embedded control-plane OpenAPI specs it resolves
  against, and the core auth/client seam
- packages/nexus-cli: local HTTP logging, the OpenAPI kind generator and the TUI
  shell bridge

The embedded OpenAPI copies move with their canonical sources, so a card can
never advertise a field or endpoint the admin API no longer accepts.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
chore(repo): sync docs, tooling, and CI config from internal main (sync 12)
feat(services): sync backend services and shared libs from internal main (sync 12)
feat(ui): sync control-plane UI, shared UI components, and tests (sync 12)
feat(deploy): sync container images and deployment manifests (sync 12)
feat(agent-core): sync the operator toolkit core and CLI (sync 12)
@Nexus-ABC
Nexus-ABC merged commit 05c7844 into main Aug 3, 2026
21 of 23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant