devendra-skill-package 1.0.2

package/.github/skills/encryption-decryption-utility/README.md

@@ -0,0 +1,222 @@
+# encryption-decryption-utility
+
+Generates and installs a complete, platform-appropriate encryption/decryption scaffold into a target project.
+Covers Angular, React, React Native, Web, Node.js, Android, iOS, and Flutter.
+
+---
+
+## What It Does
+
+- Detects existing encryption code before writing anything
+- Prompts for configuration answers (platform, approach, keys, options)
+- Writes the config file, shared EncryptionService, HTTP interceptor/middleware, and module wiring patch
+- Runs a build verification pass after installation
+
+---
+
+## Supported Platforms
+
+| Platform | Supported approaches |
+|---|---|
+| Angular | 1, 2, 3 |
+| React | 1, 2, 3 |
+| Web (browser) | 1, 2, 3 |
+| Node.js | 2, 3 |
+| Android | 2, 3 |
+| iOS | 1, 2, 3 |
+| Flutter | 2, 3 |
+| React Native | 1–6 (JS + Native + EC) |
+
+---
+
+## Supported Approaches
+
+| # | Name | Algorithm |
+|---|---|---|
+| 1 | RSA-OAEP + AES-256-GCM | Web Crypto API |
+| 2 | RSA + AES-256-CBC | jsencrypt + crypto-js |
+| 3 | AES-256-CBC shared key | crypto-js |
+| 4 | React Native JS production mode | AES-256-GCM + RSA-OAEP via react-native-quick-crypto |
+| 5 | React Native Native mode | OS-level crypto (javax.crypto / CryptoKit) |
+| 6 | EC (ECDH + AES-256-GCM) | Per-request or session-init via react-native-quick-crypto |
+
+---
+
+## How to Use This Skill
+
+### Step 1 — Install the Skill
+
+Copy the `encryption-decryption-utility` skill folder into your target project at:
+
+```
+<project-root>/.github/skills/encryption-decryption-utility/
+```
+
+On Windows (PowerShell):
+```powershell
+Copy-Item -Recurse -Path ".github\skills\encryption-decryption-utility" `
+          -Destination "C:\path\to\target-project\.github\skills\encryption-decryption-utility"
+```
+
+On macOS/Linux:
+```bash
+cp -r .github/skills/encryption-decryption-utility /path/to/target-project/.github/skills/
+```
+
+---
+
+### Step 2 — Configure the Hook
+
+Inside your `.speckit` folder, create or update the `extensions.yml` file with the content below.
+
+This hook loads all required skills automatically before implementation begins.
+
+**`.speckit/extensions.yml`**
+
+```yaml
+hooks:
+  before_implement:
+    - extension: required-skill-check
+      command: speckit-skill-check
+      description: Verify all MUST-use skills are loaded before implementation begins.
+      prompt: >
+        Inspect tasks.md, identify all tasks and break them into logical steps,
+        map each logical step to its corresponding skill, and always switch to
+        the right skill while implementing each step. If a task naturally requires
+        multiple skills, execute those skills sequentially in that task flow.
+        Reuse skills whenever similar sub-problems appear. Always ensure each
+        skill is used only for its intended purpose and avoid mixing
+        responsibilities across unrelated skills.
+      enabled: true
+      optional: false
+```
+
+---
+
+### Step 3 — Attach the skill files to your AI assistant
+
+Provide the following files as context to your AI assistant (GitHub Copilot, Claude, etc.):
+
+```
+SKILL.md
+template.md
+references/architecture.md
+references/dependency-guidance.md
+```
+
+If your chosen path is EC (approach 6), also attach:
+```
+references/ec-implementation.md
+```
+
+If your chosen path is Native (approach 5), also attach:
+```
+references/native-rsa-implementation.md
+```
+
+Also attach your existing project files:
+- Your API service / Axios instance (e.g. `src/services/api.ts`)
+- Any existing HTTP interceptors
+
+---
+
+### Step 4 — Answer the config questionnaire
+
+Open `templates/config-questionnaire.md` and fill in your answers before prompting the AI.
+
+Key decisions to make:
+
+| Decision | Options |
+|---|---|
+| Platform | angular / react / react-native / web / node / android / ios / flutter |
+| Approach | 1–6 (see table above) |
+| RSA or EC (React Native only) | RSA default; EC for forward secrecy |
+| Crypto layer (React Native only) | JS (default) or Native (OS engine) |
+| EC contract type (approach 6 only) | per-request or session-init |
+| Key source | API endpoint (default) or env variable |
+| HMAC signing | yes / no |
+| URL exclusions | comma-separated prefixes to skip |
+
+> All session-init EC questions are blocking — they have no safe defaults and must be answered explicitly.
+
+---
+
+### Step 5 — Run the Implementation
+
+1. Open **GitHub Copilot Chat**.
+2. Set the mode to **Agent** and the model to **Claude Sonnet 4.6**.
+3. Attach your questionnaire answers and the skill files listed in Step 3.
+4. Use the following prompt:
+
+**Example prompt:**
+```
+Implement the full encryption system for this project using the encryption-decryption-utility skill.
+My configuration answers are: [paste your questionnaire answers here].
+Follow the execution steps in SKILL.md and use the relevant reference files for code.
+```
+
+The AI will:
+
+1. Run `scripts/detect.js` to check for existing encryption code
+2. Prompt you once if scattered encryption is found (reuse / replace / centralize / cancel)
+3. Collect any missing required inputs
+4. Write all files and patch module wiring
+5. Run build verification
+6. Print a setup report
+
+---
+
+### Step 6 — Verify TypeScript (React Native / Angular / React)
+
+```bash
+npx tsc --noEmit
+```
+
+Expected: zero errors. See `references/dependency-guidance.md` under "Troubleshooting" for common fixes.
+
+---
+
+### Step 7 — Review before committing
+
+Work through `references/security-checklist.md` and `templates/delivery-checklist.md`.
+
+Critical items:
+- All API calls pass through the encryption interceptor
+- Excluded paths list is correct
+- Ephemeral keys are not logged or persisted
+- AES keys live in memory only
+- Build passes with zero errors
+
+---
+
+## Prerequisites
+
+| Requirement | Note |
+|---|---|
+| Node.js | >= 18 |
+| AI assistant | GitHub Copilot, Claude, or any LLM with file-context support |
+| React Native (if RN) | CLI 0.71+ only — Expo managed workflow not supported |
+| TypeScript | 4.9+ (for TS-based platforms) |
+
+---
+
+## Key Files Reference
+
+| File | Purpose |
+|---|---|
+| `SKILL.md` | Full execution steps and rules |
+| `template.md` | Layer selection gate and config snapshot — fill out at the start of each run |
+| `templates/config-questionnaire.md` | Full questionnaire with defaults |
+| `templates/implementation-plan.md` | Fill out before the AI writes any files |
+| `templates/delivery-checklist.md` | Confirm all items before final delivery |
+| `references/architecture.md` | Mode A/B architecture, request/response contract |
+| `references/backend-alignment.md` | Backend contract spec for server team (approaches 4–6) |
+| `references/dependency-guidance.md` | Library selection, version compatibility, install order |
+| `references/security-checklist.md` | Security gates — run before marking done |
+| `references/error-handling-playbook.md` | Failure paths for all platforms |
+| `references/ec-implementation.md` | Full EC implementation reference (approach 6) |
+| `references/native-rsa-implementation.md` | Full Kotlin/Swift NativeCryptoModule reference (approach 5) |
+| `Instructions.md` | Detailed walkthrough for React Native projects |
+| `scripts/detect.js` | Scans project for existing encryption code |
+| `scripts/install.js` | Writes generated files to the target project |
+| `scripts/setup.js` | Interactive wizard and orchestrator |