Amba Secret Manager Developer

Development guidelines for the Amba Secret Manager CLI tool - a .NET application that helps manage secret files (.env and .secrets folders) across different projects by saving them to a centralized user folder.

Project Overview

The Amba Secret Manager is a .NET CLI tool designed to manage secrets locally. It provides a centralized way to save and restore secret files from multiple projects.

Terminology

Core Functionality

1. **Save Profile**:

- Traverses all subfolders searching for `.env` files and `.secrets` folders

- Copies only the secrets into the user's home folder

- Maintains the original folder structure of the project

2. **Load Profile**:

- Creates `.env` files or `.secrets` folders with their content

- Restores files to their original locations in the project structure

Coding Standards

.NET Version

Testing

Development Guidelines

1. **File Operations**:

- Implement robust file traversal for finding secret files

- Preserve directory structure when saving/loading profiles

- Handle edge cases (missing directories, permission issues, etc.)

2. **Security Considerations**:

- Ensure secrets are stored securely in the user's home directory

- Implement appropriate file permissions for saved secrets

- Consider encryption for sensitive data at rest

3. **CLI Design**:

- Provide clear command-line interface with helpful messages

- Implement proper error handling and user feedback

- Support standard CLI patterns (help, version, verbose output)

4. **Profile Management**:

- Implement unique profile identification

- Support multiple profiles per user

- Provide commands to list, delete, and manage profiles

Example Commands

```bash

Build the project

dotnet build

Run the application (example)

dotnet run -- save-profile <profile-name>

dotnet run -- load-profile <profile-name>

```

Best Practices