# ClipCoffre Secret Clipboard

A GNOME Shell extension that unifies a lightweight secrets manager with clipboard favorites/history controls. It is designed as a MVP shell extension for Debian 13 (GNOME 47+) and follows the architecture outlined in `CLAUDE.md`.

## Installation
1. Run `./install.sh` to copy files into `~/.local/share/gnome-shell/extensions/secret-clipboard@gilles` and compile the schema.
2. Enable the extension using GNOME Tweaks or `gnome-extensions enable secret-clipboard@gilles`.
3. Restart GNOME Shell (`Alt+F2`, enter `r`).

## Development Commands
- `glib-compile-schemas schemas/` – compiles the GSettings schema so GNOME Shell can read `history_size`, `show_passwords`, and `click_mode`.
- `./install.sh` – synchronizes the repo with the extension directory and reruns schema compilation.

## Project Layout
- `extension.js` – entry point that wires together UI, services, and storage.
- `src/ui/` – popups, panel button, and placeholder UI components.
- `src/services/` – clipboard and secret services that talk to storage layers.
- `src/storage/` – helpers for settings, JSON persistence, clipboard, and obfuscated secrets (
  `key.json`, `secrets.json`, and `clipboard.json`).
- `schemas/` – GSettings schema for runtime configuration.
- `stylesheet.css` – theme adjustments for the topbar icon.
- `install.sh` – deployment helper with schema compilation.

## Testing Notes
- No automated tests yet. Use the manual checklist in `MANUAL_TESTS.md` to verify behavior.
- For new tests, document the framework and naming pattern (e.g. `*.test.js`).

## Next Steps
- Replace placeholder UI components (see `src/ui/`) with real paginated popovers and action buttons.
- Implement secure storage as outlined in `CLAUDE.md` (MVP obfuscation with `secretsStore.js`).
- Wire GNOME shell clipboard operations and integrate override clicks based on `click_mode`.