Skip to content

docs: sync auth, CI API, tRPC routers, and dotenv Keys UI#9

Merged
vitaliimelnychuk merged 1 commit intomainfrom
cursor/documentation-automation-system-2fba
Apr 8, 2026
Merged

docs: sync auth, CI API, tRPC routers, and dotenv Keys UI#9
vitaliimelnychuk merged 1 commit intomainfrom
cursor/documentation-automation-system-2fba

Conversation

@cursor
Copy link
Copy Markdown
Contributor

@cursor cursor bot commented Apr 5, 2026

Summary

Documentation-only update to match current behavior in src/auth.ts, src/app/api/ci/file/route.ts, tRPC routers (collections, objects, accessTokens, secrets), and the file workspace Keys UI.

Docs added/updated

  • docs/auth.md — JWT session strategy; user upsert in Postgres; removed incorrect Prisma adapter / Session model claims.
  • docs/architecture.md — Postgres stores users, grants, and access tokens; CI GET /api/ci/file flow; diagram and trust/source-of-truth sections updated.
  • docs/api-trpc.md — Full collections table (including owner-only grant procedures); objects.delete; accessTokens procedures and permission model; expanded error codes.
  • docs/storage-and-encryption.md — Keys view: add/remove constraints, draft vs save, copy via secrets.getValue.
  • README.md — HTTP contract for /api/ci/file for custom integrations beyond the composite action.

Codepaths covered

  • src/auth.ts, src/server/trpc/routers/*.ts, src/app/api/ci/file/route.ts, src/app/vault/[slug]/file/file-workspace.tsx, src/lib/dotenv-parse.ts, src/server/access/*.ts

Gaps addressed

  • Outdated Auth.js/Prisma session documentation vs JWT + users upsert.
  • Missing documentation for CI bearer token API and accessTokens tRPC surface.
  • Undocumented objects.delete and most collections procedures.
  • Undocumented dotenv Keys UI semantics (append/remove validation, save/copy).
Open in Web View Automation 

- Fix auth.md: JWT sessions and user upsert; remove obsolete Prisma adapter/session tables
- Extend architecture.md: Postgres metadata, CI route, updated diagram
- Document objects.delete, full collections and accessTokens routers in api-trpc.md
- Describe Keys view add/remove/save in storage-and-encryption.md
- Add GET /api/ci/file contract to README for custom CI integrations
@vitaliimelnychuk vitaliimelnychuk marked this pull request as ready for review April 8, 2026 15:28
@vitaliimelnychuk vitaliimelnychuk merged commit af0ef44 into main Apr 8, 2026
1 check passed
@devactivity-app
Copy link
Copy Markdown

Pull Request Summary by devActivity

Metrics

Cycle Time: 2d 23h 25m Coding Time: < 1 min Review Time: < 1 min

Achievements

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.

2 participants