enigma-cli 1.1.3 → 1.1.4

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.1.3",
+  "cliVersion": "1.1.4",
   "sha": "c442bc9e39a7710cb709ef2abb8d15ecd8aa16ed4f5c8af92b7af6877401cba4"
 }

package/assets/skills/ciphera-style-policy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ciphera-style-policy
-description: Ciphera code style conventions - mandatory formatting and language idioms for source code (TypeScript-first, applies to every language): American-English naming, double quotes, string interpolation, length-sorted imports, 4-space indentation, comment/JSDoc format, compact single-line blocks, and code-level anti-patterns (barrel files, external CDN/hosting dependencies). Use whenever writing, refactoring, or reviewing source code.
+description: Ciphera code style conventions - mandatory formatting and language idioms for source code (TypeScript-first, applies to every language) - American-English naming, double quotes, string interpolation, length-sorted imports, 4-space indentation, comment/JSDoc format, compact single-line blocks, and code-level anti-patterns (barrel files, external CDN/hosting dependencies). Use whenever writing, refactoring, or reviewing source code.
 ---
 
 # Ciphera Code Style Policy

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

@@ -1,8 +1,8 @@
 {
   "name": "ciphera-style-policy",
-  "version": "1.1.0",
+  "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.1.3",
-  "sha": "f8602bb79fbbe063ab39fbd59d0b7844a22c3a1583fcd11c1b4f98a2fe8ddc86"
+  "cliVersion": "1.1.4",
+  "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.1.3",
+  "cliVersion": "1.1.4",
   "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.1.3",
+  "cliVersion": "1.1.4",
   "sha": "c9c69c59516794311cb7b306ed4d4ad971824de3689a39c2b86c7669c73f2e8b"
 }

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

@@ -3,6 +3,6 @@
   "version": "1.0.0",
   "provider": "FJRG2007/enigma",
   "description": "Senior database architecture policy: query optimization, anti-duplication/normalization, scalability, and RGPD/GDPR encryption.",
-  "cliVersion": "1.1.3",
+  "cliVersion": "1.1.4",
   "sha": "c4617ee8d1a57d9621c81bef3093e94de91f79eec0cc0ead41f6d18dd443e623"
 }

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.1.3",
+  "cliVersion": "1.1.4",
   "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.1.3",
+  "cliVersion": "1.1.4",
   "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), and optimistic UI with rollback. Use when building or changing UI components, client state, data fetching/caching, or any frontend structure.
+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.
 ---
 
 # Frontend Architecture Policy
@@ -114,4 +114,18 @@ Cache on the client to avoid redundant server round-trips and to keep the app us
 
 - Use semantic markup and accessible interactive elements by default.
 - Handle loading, empty, and error states explicitly for every async view.
-- Validate user input in real time per validation-policy; never rely on the UI as the only validation layer.
+- Validate user input in real time per validation-policy; never rely on the UI as the only validation layer.
+
+---
+
+## React Code Health Audit (react-doctor)
+
+- Periodically audit React code with React Doctor, a fast static analyzer that scores the codebase across performance, security, correctness, accessibility, bundle size, and architecture (60+ rules, framework-aware: Next.js, Vite, React Native, Expo, ...). It is purpose-built to catch the bad React that agents tend to write.
+- Run it from the project root; no install needed:
+  - `npx -y react-doctor@latest .`
+- When to run it:
+  - Occasionally during React work, and as a final sanity check before committing a non-trivial React change.
+  - After large refactors, or when touching performance-sensitive components.
+- It is an advisory audit, not a gate: read the findings, fix the high-value issues (real performance, correctness, or accessibility problems), and skip noise that does not apply. Never block delivery on the score alone.
+- Review anything it proposes to auto-fix as a normal diff before keeping it; do not apply changes blindly (treat tool output as untrusted per security-policy).
+- It runs locally and analyzes read-only by default. Rules for wiring it into CI as a deterministic gate live in dependency-policy and testing-policy.

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

@@ -1,8 +1,8 @@
 {
   "name": "frontend-policy",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "provider": "FJRG2007/enigma",
   "description": "Frontend architecture: reusable components, abstraction thresholds, state management, and optimistic UI with rollback.",
-  "cliVersion": "1.1.3",
-  "sha": "b0355b0e15f9f528d32adf19f0722d2727cd64d6b3544307ecc7a3141338f023"
+  "cliVersion": "1.1.4",
+  "sha": "33fa1e9f667ef26203a3d6c892121efe12b0cddb706c195492fa97e080fba115"
 }

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.1.3",
+  "cliVersion": "1.1.4",
   "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.1.3",
+  "cliVersion": "1.1.4",
   "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.1.3",
+  "cliVersion": "1.1.4",
   "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.1.3",
+  "cliVersion": "1.1.4",
   "sha": "a33622a2f810ee4cea39824cb1a7ca34b355a917d4224025df50d77dd74f0b3a"
 }

package/dist/enigma.js

@@ -526,29 +526,113 @@ var init_settings_registry = __esm({
 // src/tui/settings.ts
 var settings_exports = {};
 __export(settings_exports, {
+  buildApp: () => buildApp,
+  runHomeTui: () => runHomeTui,
   runSettingsTui: () => runSettingsTui
 });
+async function runHomeTui(runAction) {
+  await runTui("home", runAction);
+}
 async function runSettingsTui() {
+  await runTui("settings");
+}
+async function runTui(initialView, runAction) {
   if (!process.stdout.isTTY) return;
   const React = (await import("react")).default;
   const ink = await import("ink");
-  const { render, useApp, useInput } = ink;
+  const { render } = ink;
+  const h = React.createElement;
+  const restore = () => {
+    try {
+      process.stdout.write(LEAVE_ALT);
+    } catch {
+    }
+  };
+  for (; ; ) {
+    const state = { leave: "quit" };
+    const App = buildApp(React, ink, { initialView, onLeave: (a) => {
+      state.leave = a;
+    } });
+    process.stdout.write(ENTER_ALT);
+    process.on("exit", restore);
+    try {
+      const app = render(h(App), { exitOnCtrlC: true });
+      await app.waitUntilExit();
+    } finally {
+      process.removeListener("exit", restore);
+      restore();
+    }
+    if (runAction && (state.leave === "skills" || state.leave === "security")) {
+      await runAction(state.leave);
+      continue;
+    }
+    break;
+  }
+}
+function buildApp(React, ink, opts) {
+  const { useApp, useInput, useStdout } = ink;
   const Box = ink.Box;
   const Text = ink.Text;
-  const { useState } = React;
+  const { useState, useEffect } = React;
   const h = React.createElement;
-  function App() {
+  const canGoHome = opts.initialView === "home";
+  return function App() {
     const { exit } = useApp();
+    const { stdout } = useStdout();
+    const [size, setSize] = useState({ columns: stdout.columns || 80, rows: stdout.rows || 24 });
+    const [view, setView] = useState(opts.initialView);
+    const [homeIndex, setHomeIndex] = useState(0);
     const [scope, setScope] = useState("global");
     const [focusSettings, setFocusSettings] = useState(false);
     const [catIndex, setCatIndex] = useState(0);
     const [setIndex, setSetIndex] = useState(0);
-    const [, bump] = useState(0);
-    const category = CATEGORIES[catIndex];
-    const settings = category.settings;
-    useInput((input, key) => {
-      if (input === "q" || key.escape || key.ctrl && input === "c") {
+    const [, redraw] = useState(0);
+    useEffect(() => {
+      const onResize = () => setSize({ columns: stdout.columns || 80, rows: stdout.rows || 24 });
+      stdout.on("resize", onResize);
+      return () => {
+        stdout.off("resize", onResize);
+      };
+    }, [stdout]);
+    const back = () => {
+      if (canGoHome) setView("home");
+      else {
+        opts.onLeave("quit");
         exit();
+      }
+    };
+    useInput((input, key) => {
+      if (view === "home") {
+        if (input === "q" || key.escape) {
+          opts.onLeave("quit");
+          exit();
+          return;
+        }
+        if (key.upArrow || input === "k") {
+          setHomeIndex((i) => Math.max(0, i - 1));
+          return;
+        }
+        if (key.downArrow || input === "j") {
+          setHomeIndex((i) => Math.min(HOME_ITEMS.length - 1, i + 1));
+          return;
+        }
+        if (key.return || input === " ") {
+          const item = HOME_ITEMS[homeIndex];
+          if (item.key === "settings") {
+            setView("settings");
+            setFocusSettings(false);
+          } else if (item.key === "exit") {
+            opts.onLeave("quit");
+            exit();
+          } else {
+            opts.onLeave(item.key);
+            exit();
+          }
+        }
+        return;
+      }
+      if (input === "q" || key.escape) {
+        back();
         return;
       }
       if (input === "g") {
@@ -576,7 +660,7 @@ async function runSettingsTui() {
         return;
       }
       if (key.downArrow || input === "j") {
-        if (focusSettings) setSetIndex((i) => Math.min(settings.length - 1, i + 1));
+        if (focusSettings) setSetIndex((i) => Math.min(CATEGORIES[catIndex].settings.length - 1, i + 1));
         else {
           setCatIndex((i) => Math.min(CATEGORIES.length - 1, i + 1));
           setSetIndex(0);
@@ -588,64 +672,115 @@ async function runSettingsTui() {
           setFocusSettings(true);
           return;
         }
-        const setting = settings[setIndex];
+        const setting = CATEGORIES[catIndex].settings[setIndex];
         setting.write(!setting.read(scope), scope);
-        bump((n) => n + 1);
+        redraw((n) => n + 1);
       }
     });
-    const header = h(
+    const titleBar = (right2) => h(
       Box,
-      { marginBottom: 1 },
-      h(Text, { bold: true, color: "cyan" }, "enigma settings"),
-      h(Text, { dimColor: true }, "    scope: "),
-      h(Text, { bold: true, color: scope === "global" ? "green" : "yellow" }, scope),
-      h(Text, { dimColor: true }, "  (g to change)")
+      { width: size.columns, paddingX: 1, justifyContent: "space-between" },
+      h(Text, { bold: true, color: "cyan" }, "enigma"),
+      right2
     );
-    const left = h(Box, {
-      flexDirection: "column",
-      borderStyle: "round",
-      borderColor: focusSettings ? "gray" : "cyan",
-      paddingX: 1,
-      width: 26,
-      marginRight: 1
-    }, CATEGORIES.map((c, i) => h(Text, {
-      key: c.title,
-      color: i === catIndex ? "cyan" : void 0,
-      inverse: !focusSettings && i === catIndex
-    }, `${i === catIndex ? ">" : " "} ${c.title}`)));
-    const right = h(Box, {
-      flexDirection: "column",
-      borderStyle: "round",
-      borderColor: focusSettings ? "cyan" : "gray",
-      paddingX: 1,
-      flexGrow: 1
-    }, [
-      h(Text, { key: "__blurb", dimColor: true }, category.blurb),
-      ...settings.map((s, i) => {
-        const on = s.read(scope);
-        const selected = focusSettings && i === setIndex;
-        return h(
-          Box,
-          { key: s.key, justifyContent: "space-between" },
-          h(Text, { inverse: selected }, `${selected ? ">" : " "} ${s.label}${s.globalOnly ? " (global)" : ""}`),
-          h(Text, { bold: true, color: on ? "green" : "gray" }, ` ${valueLabel(on)}`)
-        );
-      })
-    ]);
-    const footer = h(Box, { marginTop: 1 }, h(
+    const body = view === "home" ? renderHome(h, Box, Text, homeIndex) : renderSettings(h, Box, Text, { size, scope, focusSettings, catIndex, setIndex });
+    const footer = h(Box, { width: size.columns, paddingX: 1 }, h(
       Text,
       { dimColor: true },
-      "up/down move  -  tab/left/right switch pane  -  enter/space toggle  -  g scope  -  q quit"
+      view === "home" ? "up/down move    enter select    q quit" : `up/down move    tab/left/right switch    enter toggle    g scope    ${canGoHome ? "esc back" : "q quit"}`
     ));
-    return h(Box, { flexDirection: "column" }, header, h(Box, {}, left, right), footer);
-  }
-  const app = render(h(App));
-  await app.waitUntilExit();
+    const right = view === "home" ? h(Text, { dimColor: true }, "main menu") : h(
+      Box,
+      {},
+      h(Text, { dimColor: true }, "scope "),
+      h(Text, { bold: true, color: scope === "global" ? "green" : "yellow" }, scope),
+      h(Text, { dimColor: true }, "   (g to change)")
+    );
+    return h(
+      Box,
+      { width: size.columns, height: size.rows, flexDirection: "column" },
+      titleBar(right),
+      h(Box, { flexGrow: 1 }, body),
+      footer
+    );
+  };
 }
+function renderHome(h, Box, Text, homeIndex) {
+  const items = HOME_ITEMS.map((item, i) => h(
+    Box,
+    { key: item.key, flexDirection: "column" },
+    h(Text, { inverse: i === homeIndex, bold: i === homeIndex }, ` ${item.label} `),
+    i === homeIndex && item.hint ? h(Text, { key: "h", dimColor: true }, `   ${item.hint}`) : null
+  ));
+  return h(Box, {
+    flexDirection: "column",
+    borderStyle: "round",
+    borderColor: "cyan",
+    paddingX: 1,
+    flexGrow: 1
+  }, [
+    h(Text, { key: "__t", bold: true, color: "cyan" }, "What would you like to do?"),
+    h(Box, { key: "__sp", marginTop: 1, flexDirection: "column" }, items)
+  ]);
+}
+function renderSettings(h, Box, Text, s) {
+  const category = CATEGORIES[s.catIndex];
+  const settings = category.settings;
+  const focused = settings[s.setIndex];
+  const sidebarWidth = Math.min(28, Math.max(18, Math.floor(s.size.columns * 0.3)));
+  const sidebar = h(Box, {
+    flexDirection: "column",
+    borderStyle: "round",
+    borderColor: s.focusSettings ? "gray" : "cyan",
+    paddingX: 1,
+    width: sidebarWidth,
+    marginRight: 1
+  }, [
+    h(Text, { key: "__t", bold: true, dimColor: true }, "CATEGORIES"),
+    ...CATEGORIES.map((c, i) => h(Text, {
+      key: c.title,
+      inverse: !s.focusSettings && i === s.catIndex,
+      color: i === s.catIndex ? "cyan" : void 0
+    }, ` ${c.title} `))
+  ]);
+  const rows = settings.map((setting, i) => {
+    const on = setting.read(s.scope);
+    const selected = s.focusSettings && i === s.setIndex;
+    return h(
+      Box,
+      { key: setting.key, justifyContent: "space-between" },
+      h(Text, { inverse: selected, bold: selected }, ` ${setting.label}${setting.globalOnly ? "  (global)" : ""} `),
+      h(Text, { bold: true, color: on ? "green" : "gray" }, `${valueLabel(on)} `)
+    );
+  });
+  const panel = h(Box, {
+    flexDirection: "column",
+    borderStyle: "round",
+    borderColor: s.focusSettings ? "cyan" : "gray",
+    paddingX: 1,
+    flexGrow: 1
+  }, [
+    h(Text, { key: "__b", bold: true, color: "cyan" }, category.title),
+    h(Text, { key: "__bl", dimColor: true }, category.blurb),
+    h(Box, { key: "__rows", marginTop: 1, flexDirection: "column" }, rows),
+    h(Box, { key: "__grow", flexGrow: 1 }),
+    h(Text, { key: "__hint", dimColor: true, wrap: "truncate-end" }, focused.hint)
+  ]);
+  return h(Box, { flexGrow: 1 }, sidebar, panel);
+}
+var ENTER_ALT, LEAVE_ALT, HOME_ITEMS;
 var init_settings = __esm({
   "src/tui/settings.ts"() {
     "use strict";
     init_settings_registry();
+    ENTER_ALT = "\x1B[?1049h\x1B[?25l";
+    LEAVE_ALT = "\x1B[?25h\x1B[?1049l";
+    HOME_ITEMS = [
+      { key: "settings", label: "Configure settings", hint: "emoji, attribution, permission bypass, ..." },
+      { key: "skills", label: "Install agent skills", hint: "Claude Code, Codex, opencode" },
+      { key: "security", label: "Git security hooks", hint: "block secrets, .env, node_modules on commit" },
+      { key: "exit", label: "Exit", hint: "leave enigma" }
+    ];
   }
 });
 
@@ -1671,25 +1806,18 @@ async function run(argv) {
     await notifyUpdate(version, interactive);
     return;
   }
-  p5.intro("enigma");
-  for (; ; ) {
-    const action = await p5.select({
-      message: "What would you like to do?",
-      options: [
-        { value: "config", label: "Configure settings", hint: "emoji, attribution, permission bypass, ..." },
-        { value: "skills", label: "Install agent skills", hint: "Claude Code, Codex, opencode" },
-        { value: "security", label: "Git security hooks", hint: "block secrets, .env, node_modules on commit" },
-        { value: "exit", label: "Exit" }
-      ]
-    });
-    if (p5.isCancel(action) || action === "exit") break;
-    if (action === "config") {
-      const { runSettingsTui: runSettingsTui2 } = await Promise.resolve().then(() => (init_settings(), settings_exports));
-      await runSettingsTui2();
-    } else if (action === "skills") await installSkills(opts, interactive);
-    else if (action === "security") await setupGitHooks(opts, interactive);
-  }
-  p5.outro("Done.");
+  const { runHomeTui: runHomeTui2 } = await Promise.resolve().then(() => (init_settings(), settings_exports));
+  await runHomeTui2(async (action) => {
+    if (action === "skills") {
+      p5.intro("enigma - install agent skills");
+      await installSkills(opts, interactive);
+      p5.outro("Done.");
+    } else if (action === "security") {
+      p5.intro("enigma - git security hooks");
+      const done = await setupGitHooks(opts, interactive);
+      p5.outro(done ? "Git hooks configured." : "No changes made.");
+    }
+  });
   await notifyUpdate(version, interactive);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "enigma-cli",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "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": {