Skip to content

feat: enroll multiple cvlt installations - #12

Merged
ygpark80 merged 2 commits into
mainfrom
feat/multi-client-enrollment
Aug 23, 2026
Merged

feat: enroll multiple cvlt installations#12
ygpark80 merged 2 commits into
mainfrom
feat/multi-client-enrollment

Conversation

@ygpark80

@ygpark80 ygpark80 commented Aug 23, 2026

Copy link
Copy Markdown
Contributor

User description

Part of #11

Changes

  • add cvlt client request, approve, list, and revoke
  • add deterministic public enrollment requests and single-use possession proofs
  • reuse origin-scoped device keys across accounts and destructive recovery
  • propagate installation identity through Node and Go data reads without breaking API-key or OIDC flows
  • add CLI/PTY, SDK, key-store, and repeatable Linux two-store coverage

Testing

  • bun test node/src/ cli/src/ — 143 tests pass, 1 host-store test skipped in the generic run
  • CVLT_TEST_OS_KEYSTORE=1 bun test node/src/key-store.test.ts — macOS Keychain passes
  • npm run build:sdk
  • bun run build
  • (cd go && go test ./...)
  • shellcheck -S warning scripts/*.sh
  • macOS Keychain A ↔ OrbStack Linux B enroll/list/revoke/re-enroll with identical canary hashes
  • Linux two-encrypted-store automated E2E with audit readback and cleanup
  • recovery-envelope hash unchanged across re-enrollment

Notes

  • Production rollout follows the server PR merge and production D1 migration.

CodeAnt-AI Description

Enable secure enrollment and management of multiple Vault installations

What Changed

  • Add cvlt client request, approve, list, and revoke for adding, reviewing, listing, disabling, and re-enabling installations without destructive recovery
  • Enrollment requests contain only validated public information, use stable fingerprints, and require matching origin/account details plus explicit terminal confirmation
  • Reuse one installation key per Vault origin across accounts and recovery, while keeping existing installations usable
  • Send installation identity on protected Vault data reads so revoked installations lose access immediately; API-key and OIDC workflows remain compatible
  • Keep command output safe for automation by separating tokens from diagnostics, protecting JSON output, and sanitizing terminal table values
  • Add Node, CLI, Go, end-to-end, and documentation coverage for two-installation enrollment, revocation, re-enrollment, and fingerprint validation

Impact

✅ Add a second machine without recovery
✅ Revoked installations lose Vault read access
✅ Safer enrollment confirmation
✅ Stable automation output

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

@ygpark80 ygpark80 linked an issue Aug 23, 2026 that may be closed by this pull request
14 tasks
@codeant-ai

codeant-ai Bot commented Aug 23, 2026

Copy link
Copy Markdown

🤖 CodeAnt AI — Review Status

Status Commit Started (UTC) Finished (UTC)
✅ Reviewed your PR 532e89e Aug 23, 2026 · 10:38 10:42

@codeant-ai

codeant-ai Bot commented Aug 23, 2026

Copy link
Copy Markdown

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@coderabbitai

coderabbitai Bot commented Aug 23, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d026eef8-d7b7-4163-a2dd-22fb0d222c55


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@codeant-ai codeant-ai Bot added the size:XXL This PR changes 1000+ lines, ignoring generated files label Aug 23, 2026
@ygpark80
ygpark80 merged commit 824309d into main Aug 23, 2026
2 checks passed
@ygpark80
ygpark80 deleted the feat/multi-client-enrollment branch August 23, 2026 10:41
Comment thread node/src/e2ee-client.ts
Comment on lines +1288 to +1292
const device = existing ?? await generateDeviceKey()
if (!existing) {
await saveDeviceKey(origin, device)
rememberDeviceKey(origin, device)
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: When two processes call createClientEnrollmentRequest while the origin has no stored key, both can observe existing as null, generate different keys, and overwrite the same origin-scoped store. The request returned by the process that saves first can then refer to a key that is no longer stored, so approval succeeds but that process cannot later read or authenticate. Serialize creation across processes or re-read the store after generation and preserve the winning key. [race condition]

Severity Level: Major ⚠️
- ❌ One concurrent enrollment request becomes unusable.
- ⚠️ Origin key storage can orphan a newly registered installation.

Use CodeAnt Skill

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** node/src/e2ee-client.ts
**Line:** 1288:1292
**Comment:**
	*Race Condition: When two processes call `createClientEnrollmentRequest` while the origin has no stored key, both can observe `existing` as null, generate different keys, and overwrite the same origin-scoped store. The request returned by the process that saves first can then refer to a key that is no longer stored, so approval succeeds but that process cannot later read or authenticate. Serialize creation across processes or re-read the store after generation and preserve the winning key.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL This PR changes 1000+ lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: enroll and manage multiple cvlt installations per account

1 participant