enigma-cli 1.10.2 → 1.11.1

package/README.md

@@ -27,6 +27,36 @@ launching a tool through enigma (e.g. `enigma claude`) auto-syncs the deployed
 skills and memory with the installed package version (see
 [Auto-sync](#auto-sync-on-launch)).
 
+## Requirements
+
+**Minimum:** [Node.js](https://nodejs.org) `>= 18` (with `npm`), [Git](https://git-scm.com)
+and at least one coding agent. **Recommended:** add [Claude Code](https://claude.com/claude-code),
+the [GitHub CLI](https://cli.github.com), [Bun](https://bun.sh) and [Warp](https://www.warp.dev).
+
+<details>
+<summary><b>Details</b> - what each one is for</summary>
+
+### Minimum
+
+|  |  |
+|--|--|
+| <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js"/></a> | `>= 18`, ships with `npm` - installs and runs the `enigma` CLI |
+| <a href="https://git-scm.com"><img src="https://img.shields.io/badge/Git-F05032?style=for-the-badge&logo=git&logoColor=white" alt="Git"/></a> | powers the security hooks and the commit guard |
+| <img src="https://img.shields.io/badge/Coding%20agent-555555?style=for-the-badge&logo=claude&logoColor=white" alt="Coding agent"/> | at least one of [Claude Code](https://claude.com/claude-code), [OpenAI Codex](https://github.com/openai/codex) or [opencode](https://opencode.ai) - the skills need a home |
+
+### Recommended
+
+Everything in **Minimum**, plus:
+
+|  |  |
+|--|--|
+| <a href="https://claude.com/claude-code"><img src="https://img.shields.io/badge/Claude%20Code-D97757?style=for-the-badge&logo=claude&logoColor=white" alt="Claude Code"/></a> | the agent enigma is most battle-tested with |
+| <a href="https://cli.github.com"><img src="https://img.shields.io/badge/GitHub%20CLI-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub CLI"/></a> | `gh` commits go through the same hooks, and `enigma issue` opens prefilled reports |
+| <a href="https://bun.sh"><img src="https://img.shields.io/badge/Bun-000000?style=for-the-badge&logo=bun&logoColor=white" alt="Bun"/></a> | only needed to build or contribute from source |
+| <a href="https://www.warp.dev"><img src="https://img.shields.io/badge/Warp-01A4FF?style=for-the-badge&logo=warp&logoColor=white" alt="Warp"/></a> | a modern terminal where the hub TUI shines |
+
+</details>
+
 ## Commands
 
 ```
@@ -40,6 +70,7 @@ enigma <tool> [acct]   Launch claude | codex | opencode with an account
                        auto-syncs deployed skills first
 enigma account ...     Manage per-tool accounts (list/add/use/login/remove)
 enigma profile ...     Group one account per tool (list/add/use/set/unset/remove)
+enigma skills ...      List skills and manage discards (list/discard/restore)
 enigma seal            Maintenance: (re)compute skill content hashes
 enigma check           Integrity gate: verify skills are well-formed and sealed
 enigma help | version
@@ -60,6 +91,12 @@ preselects them; `--all` targets every supported agent.
 
 (`--local` installs into the current project instead.)
 
+Don't want one of the skills? Discard it from the hub's install panel (the
+SKILLS section lists every skill; unchecking one discards it) or with
+`enigma skills discard <name>`: it is removed from every agent and skipped by
+future installs, updates and auto-syncs until you restore it with
+`enigma skills restore <name>`.
+
 ## Auto-sync on launch
 
 After the first `enigma install`, you never need to run it again: whenever you

package/assets/skills/backend-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.0.0",
   "provider": "FJRG2007/enigma",
   "description": "Backend/API architecture: controller-service-repository layering, API and request optimization, server-side caching (Redis), and Zod boundary validation.",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "c442bc9e39a7710cb709ef2abb8d15ecd8aa16ed4f5c8af92b7af6877401cba4"
 }

package/assets/skills/ciphera-style-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.1.1",
   "provider": "FJRG2007/enigma",
   "description": "Ciphera code style conventions (formatting, naming, imports, comments, code-level anti-patterns; TypeScript-first, language-agnostic).",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "74f638aec13e8c93257fe1ad604c28b07e9a7c456796a4ceefcc99217d9e7039"
 }

package/assets/skills/code-review-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.0.0",
   "provider": "FJRG2007/enigma",
   "description": "Pre-delivery self-review gate, prioritized review dimensions, and change-quality criteria.",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "3d3bbe0602d5bbb4afe37648fe3c2fa39376b1bcbac5d8c441f01fad1e866ed0"
 }

package/assets/skills/core-engineering-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.4.0",
   "provider": "FJRG2007/enigma",
   "description": "Core engineering execution policy and harness orchestration (highest-authority rules).",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "c9c69c59516794311cb7b306ed4d4ad971824de3689a39c2b86c7669c73f2e8b"
 }

package/assets/skills/database-expert/skill.json

@@ -3,6 +3,6 @@
   "version": "1.1.0",
   "provider": "FJRG2007/enigma",
   "description": "Senior database architecture policy: query optimization, anti-duplication/normalization, scalability, and RGPD/GDPR encryption.",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "2883bcecb3202683ae6f81b073c3d6a9cec9c55029e011bdd06ba7ac3537297e"
 }

package/assets/skills/debugging-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.0.0",
   "provider": "FJRG2007/enigma",
   "description": "Reproduce-isolate-fix debugging methodology with root-cause discipline and regression verification.",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "14b0064c8b33a0dc85e51464b05005cf5801c756b1101789a6924b9548420f6b"
 }

package/assets/skills/dependency-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.0.0",
   "provider": "FJRG2007/enigma",
   "description": "Dependency and supply-chain security: lockfiles and reproducible installs, version pinning, vulnerability auditing, vetting/minimizing packages, vendoring, and SBOM/provenance.",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "6375d835c2aef2c9bd31ce116444dc3d796f510f9970a213aa3ac4696d7e21b9"
 }

package/assets/skills/frontend-policy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: frontend-policy
-description: Frontend architecture - reusable components, abstraction thresholds, state management, client-side caching (localStorage/sessionStorage to avoid redundant server calls and survive rate limits), optimistic UI with rollback, and periodic React code-health audits (react-doctor). Use when building or changing UI components, client state, data fetching/caching, auditing React code, or any frontend structure.
+description: Frontend architecture - reusable components, abstraction thresholds, state management, no-op save detection (skip mutations when the edited state equals the saved state), client-side caching (localStorage/sessionStorage to avoid redundant server calls and survive rate limits), optimistic UI with rollback, and periodic React code-health audits (react-doctor). Use when building or changing UI components, client state, forms/save flows, data fetching/caching, auditing React code, or any frontend structure.
 ---
 
 # Frontend Architecture Policy
@@ -66,6 +66,31 @@ description: Frontend architecture - reusable components, abstraction thresholds
 
 ---
 
+## No-Op Save Detection (Dirty-State Check)
+
+Before sending a save/update mutation, compare the edited state against the last-known saved state. If they are equal, the save is a no-op: skip the request entirely.
+
+### The rule
+
+- Track the saved (pristine) snapshot of the form/settings when it loads or after a successful save.
+- Compute dirtiness by comparing the current edited values against that snapshot (deep/structural equality on the fields being saved), not by counting user interactions.
+  - Example: a value goes from state x to state z, then back to x before saving. The net change is zero - the form is NOT dirty, and pressing Save must send nothing to the backend.
+- When the form is not dirty, the Save action does nothing (and the button should reflect it, e.g. disabled or neutral); no request, no spinner, no toast.
+- When partial updates are supported, send only the changed fields (a diff against the snapshot), not the full object.
+- After a successful save, replace the snapshot with the newly saved state so subsequent edits diff against it.
+
+### When NOT to apply it (judgment call)
+
+This is the default, not an absolute. Skip the no-op check and allow the save to go through when overwriting has value on its own:
+
+- The resource is edited concurrently by many users or updated constantly server-side, and an explicit save is meant to assert/overwrite the user's view ("last write wins" by intent).
+- Saving has intentional side effects beyond persisting values: bumping `updatedAt`, re-triggering a pipeline/deploy, re-validating, or acknowledging a state.
+- The client snapshot cannot be trusted to match the server (long-lived stale forms) and the save doubles as a sync.
+
+Decide per case which mode fits; when in doubt for simple single-user forms and settings panels, apply the no-op check.
+
+---
+
 ## Client-Side Caching (Reduce Server Load)
 
 Cache on the client to avoid redundant server round-trips and to keep the app usable under rate limits. The goal is to reach the backend (and therefore Redis/DB) as rarely as correctness allows.

package/assets/skills/frontend-policy/skill.json

@@ -1,8 +1,8 @@
 {
   "name": "frontend-policy",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "provider": "FJRG2007/enigma",
-  "description": "Frontend architecture: reusable components, abstraction thresholds, state management, and optimistic UI with rollback.",
-  "cliVersion": "1.10.2",
-  "sha": "33fa1e9f667ef26203a3d6c892121efe12b0cddb706c195492fa97e080fba115"
+  "description": "Frontend architecture: reusable components, abstraction thresholds, state management, no-op save detection, and optimistic UI with rollback.",
+  "cliVersion": "1.11.1",
+  "sha": "3766096616a9177ce66685bfaaaef66f7e8ceb62e2a6542e83dee713b9d1b56f"
 }

package/assets/skills/git-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.2.0",
   "provider": "FJRG2007/enigma",
   "description": "Git & contribution policy (senior engineering standards).",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "ada4b7eb5bb7e013429e23703c271c0f34b0d76327c059efa148ea2794f96178"
 }

package/assets/skills/security-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.0.0",
   "provider": "FJRG2007/enigma",
   "description": "Application and AI-agent security: secrets, authn/authz (least privilege), OWASP Top 10, transport/crypto baseline, secure logging, and agent/MCP/tool-use safety.",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "9971e9d9127397d0152e89d24aad3191e2935e55a8483db7fd15f5d4d7a60e7a"
 }

package/assets/skills/testing-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.0.0",
   "provider": "FJRG2007/enigma",
   "description": "Test strategy, coverage gates, deterministic tests, mocking discipline, and regression-first bug fixing.",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "d19fa8ec7985ed231478be504d3c80360897f555d0bc0624bea19c091f459fb0"
 }

package/assets/skills/validation-policy/skill.json

@@ -3,6 +3,6 @@
   "version": "1.0.0",
   "provider": "FJRG2007/enigma",
   "description": "Strict frontend + backend schema validation, schema consistency, and safe client-facing error handling.",
-  "cliVersion": "1.10.2",
+  "cliVersion": "1.11.1",
   "sha": "a33622a2f810ee4cea39824cb1a7ca34b355a917d4224025df50d77dd74f0b3a"
 }

package/bin/checksums.json

@@ -1,6 +1,6 @@
 {
-  "enigma-darwin-arm64": "07944065136191de2102b4abd6331e80b342b9b000ad40ca2d49436a4d91dd03",
-  "enigma-linux-arm64": "f2d8365102101a34703438c94f944c8e43d609d128fe3447f500332eb72e850d",
-  "enigma-linux-x64": "59a5e2f96d7b7bc934c3c84e8db6a1e45998cbde0ee5458f0c97e42cff93bef9",
-  "enigma-win32-x64.exe": "16abc27ef2306d1700244ef8dcd4028bc108a1c9a6fde2e51a02cc82645e106a"
+  "enigma-darwin-arm64": "aa6df4e33d82f6e74854639fa88d5e81101cb7411a12b76323a3a50be380bb6d",
+  "enigma-linux-arm64": "ef5586207dd65386c9564dfbeb96dc5f9270cb1d5e6427ab980234554bc1b5aa",
+  "enigma-linux-x64": "ad1fbd7edadfb70f6281f4e59c64145f30f692daf3987cdb25b720f832d08f41",
+  "enigma-win32-x64.exe": "82f637201d6debfe44d66c2fcce737ee7ef8f7442216b09b3ac9e44b46ffa605"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "enigma-cli",
-  "version": "1.10.2",
+  "version": "1.11.1",
   "description": "Everything you need to work with a coding agent: install shared policy skills for Claude Code, OpenAI Codex and opencode, and set up portable git security hooks.",
   "type": "module",
   "bin": {