dme-agent 7.4.1 → 9.69.0

package/assets/skills/dme-shadcn/SKILL.md

@@ -1,14 +1,136 @@
 ---
 name: dme-shadcn
 description: >
-  Force shadcn/ui-first implementation. Stop reinventing Button/Input/Dialog.
-  Triggers: /dme-shadcn, shadcn, add component, ui primitive.
+  DME 9.69 shadcn-first composition skill. Install and compose primitives;
+  never reinvent Button/Input/Dialog/Table/Sidebar. Triggers: /dme-shadcn,
+  shadcn, compose UI, install components, don't reinvent primitives, ui atoms.
 ---
 
-# DME shadcn First
+# DME shadcn 9.69 — Compose, Don't Invent
 
-Map UI → `npx shadcn@latest add …` → CSS variables → compose domain blocks.
+Law: **if shadcn has it, you use it.** You are a composer, not a component factory.
 
-Never hand-roll atoms that exist. Customize via tokens, className, cva, asChild.
+## When this skill owns the room
 
-Card is allowed as primitive; DME still forbids text-bloat inside cards.
+- Scaffolding any product UI, dashboard, landing form, dialog flow, table, sidebar
+- He says “use shadcn”, “don’t hand-roll”, “install components”
+- You feel the urge to write a custom Button or Modal from scratch → stop
+
+## Install discipline
+
+```bash
+npx shadcn@latest add button input label textarea select checkbox radio-group
+npx shadcn@latest add dialog sheet drawer popover dropdown-menu
+npx shadcn@latest add table tabs badge separator skeleton sonner tooltip
+npx shadcn@latest add card form accordion progress pagination
+npx shadcn@latest add sidebar command scroll-area avatar switch
+```
+
+Add only what the surface needs. Prefer one `add` batch over drive-by custom CSS atoms.
+
+## Primitive map (default to these)
+
+| Need | Use |
+|------|-----|
+| Actions | `Button` variants: default, secondary, outline, ghost, destructive |
+| Text | `Input` + `Label` · `Textarea` · `InputOTP` if needed |
+| Choice | `Select` · `Checkbox` · `RadioGroup` · `Switch` |
+| Overlay | `Dialog` (decision) · `Sheet` (detail/side) · `Drawer` (mobile) · `Popover` |
+| Menus | `DropdownMenu` · `ContextMenu` · `Command` (palette) |
+| Data | `Table` + `Pagination` · never fake tables with div grids for tabular data |
+| Chrome | `Sidebar` · `Tabs` · `Breadcrumb` · `Separator` · `ScrollArea` |
+| Feedback | `Sonner` toasts · `Progress` · `Skeleton` · `Badge` · `Alert` |
+| Structure | `Card` only when entity/KPI/plan/media — not for every paragraph |
+| Forms | `Form` (RHF + zod) when validation matters |
+
+## Compose patterns
+
+### Work surface (dashboard)
+
+```
+SidebarProvider
+  Sidebar
+  SidebarInset
+    header: search | filters | Button(CTA)
+    metric strip: plain numbers (not Card essays)
+    Table | list (divide-y)
+    Sheet | Dialog for detail/create
+```
+
+### Decision modal
+
+```
+Dialog
+  DialogHeader (title + 1 line description)
+  body ≤ 2–3 lines + fields
+  DialogFooter: outline cancel + primary verb
+```
+
+### Detail without route change
+
+```
+Sheet side="right"
+  identity header
+  dl / Table / Tabs
+  sticky footer actions
+```
+
+### Empty
+
+```
+short title
+one helper line
+one Button CTA
+```
+
+No illustration spam unless brand requires it.
+
+## Styling rules (peace / 9.69)
+
+- Extend via `className` + CVA variants — don’t fork the primitive file unless token-level
+- Radius ≤ 8px; keep shadcn radius tokens consistent with zinc peace palette
+- Prefer `variant` and `size` over one-off colored divs
+- Dark: bg `#09090b`, raise `#18181b`; Light: white/zinc-50 peace
+- Accent sparingly on primary Button / key Badge — not every border
+
+## Anti-patterns (instant fail)
+
+| Fail | Fix |
+|------|-----|
+| Custom `<button className="...">` for primary actions | `Button` |
+| Hand-rolled modal with fixed overlay | `Dialog` / `Sheet` |
+| Div soup “table” | `Table` |
+| Card wrapping every sentence | list / `Separator` / bare layout |
+| Rebuilding toast system | `Sonner` |
+| Custom sidebar from scratch | `Sidebar` primitives |
+| Icon+title+paragraph feature grid as “design system” | not a system — delete |
+
+## Accessibility (ships with shadcn — keep it)
+
+- Don’t strip `Dialog` focus trap or `Label` association
+- Icon-only `Button` → `aria-label` or `sr-only` text
+- Touch targets ≥ 44px on mobile (size default / padding)
+- Focus rings visible — never `outline-none` without replacement
+
+## Motion pairing
+
+Primitives stay dumb; motion wraps them:
+
+```tsx
+<motion.div {...fadeUp}>
+  <Card>...</Card>
+</motion.div>
+```
+
+Don’t animate in a way that breaks Dialog/Sheet exit. See `/dme-motion`.
+
+## Checklist
+
+- [ ] Listed needed primitives before coding  
+- [ ] Installed via shadcn CLI (or confirmed present)  
+- [ ] Zero hand-rolled atoms that exist upstream  
+- [ ] Cards lean; tables for tabular data  
+- [ ] Forms labeled; errors human  
+- [ ] Composed shell matches platform (web vs app)  
+
+**Compose. Don’t invent.**

package/assets/skills/dme-ux/SKILL.md

@@ -1,53 +1,136 @@
 ---
 name: dme-ux
 description: >
-  Human-centered UX doctrine for non-developers. Microcopy, flows, forms,
-  onboarding, errors, accessibility. Triggers: /dme-ux, UX, usabilidade,
-  microcopy, onboarding, empty state, formulário.
+  DME 9.69 human UX for non-developers: addiction via ease not dark patterns,
+  microcopy caps, clear verbs, complete states. Triggers: /dme-ux, UX writing,
+  microcopy, empty state, onboarding UX, usability, human UI, dark patterns.
 ---
 
-# DME UX — Humans First
+# DME UX 9.69 — Ease, Not Traps
 
-## Default user
+Audience default: **humans who don’t code**. They scan. They fear mistakes. Next step must be obvious.
 
-Not a developer. Scans. Fears mistakes. Wants the next step obvious.
+## Goal
 
-## Laws
+Make the product **habit-forming through ease**: fast success, clear recovery, low shame.  
+**Never** through dark patterns (forced continuity, hidden costs, fake urgency, trick checkboxes).
 
-1. Recognition over recall  
-2. Immediate feedback (<150ms state)  
-3. Prevent errors; confirm destructive  
-4. Easy exit / undo  
-5. Progressive disclosure  
-6. Consistent patterns  
-7. A11y: contrast, focus, 44px targets, labeled inputs  
-8. Button = real verb  
-9. Full states: empty · loading · partial · success · error · offline  
-10. First-minute magic: one valuable action  
+## Core loop (ethical stickiness)
 
-## Microcopy caps
+1. **One obvious primary action** per view  
+2. **Time-to-first-success** as short as honest  
+3. **Forgiving errors** — say what happened + how to continue  
+4. **Memory** — remember filters, last place, drafts  
+5. **Feedback** — every action gets a visible result (toast, row update, progress)  
+
+If they return, it’s because work was easier — not because leave was hard.
+
+## Microcopy caps (hard)
 
 | Element | Max |
-|---|---|
+|---------|-----|
 | Field label | 3 words |
 | Helper | 1 line |
 | Card body | 1–2 lines |
 | Toast | 1 line |
-| Empty | title + 1 line + CTA |
+| Modal body | 2–3 lines |
 | Hero lead | 1 sentence |
+| Empty title | 3–6 words |
+| Error | 1–2 lines + action |
+
+### Buttons = verbs
+
+`Salvar` · `Criar pedido` · `Enviar` · `Aprovar` · `Tentar de novo`  
+
+Not: `OK` · `Submit` · `Click here` · `Explore`
+
+### Errors
+
+```
+Não deu para salvar.
+Verifique a conexão e tente de novo.
+[ Tentar de novo ]
+```
+
+Never stack traces, never blame, never “unexpected error” alone.
+
+## States (every surface)
+
+| State | Content |
+|-------|---------|
+| Empty | title + one line + one CTA |
+| Loading | skeleton geometry of result |
+| Success | toast or inline confirm, 1 line |
+| Error | cause + recovery |
+| Offline | honest status + safe actions only |
+
+## Progressive disclosure
 
-## Translate errors
+- Defaults cover 80%  
+- “Mais opções” / advanced filters collapsed  
+- Dangerous stuff: Dialog confirm with consequence in plain language  
 
-Dev message → human cause + next action. Never dump stack traces.
+## Onboarding (UX lens)
+
+Value → account → **one** essential setup → first success.  
+
+No 12-tooltip product tours. For motion/craft detail → `/dme-welcome`.
 
 ## Forms
 
-One column · external labels · inline errors · primary at end · autosave if long.
+- Labels outside fields (visible)  
+- Placeholders are examples, not labels  
+- Inline validation after blur or submit — not while first keystroke  
+- Password managers / autocomplete respected  
+- Required: mark few; don’t asterisk everything  
+
+## Navigation & wayfinding
+
+- Current location always clear  
+- Destructive far from primary when possible  
+- Back restores context (scroll, filters)  
+
+## Addiction via ease (allowed)
+
+- Keyboard shortcuts for power users (discoverable)  
+- Optimistic UI when safe  
+- Smart defaults  
+- Undo instead of scary confirms when reversible  
+- Fast search (`Command`)  
+
+## Dark patterns (banned)
+
+| Pattern | Why banned |
+|---------|------------|
+| Confirmshaming (“No, I hate saving time”) | contempt |
+| Hidden unsubscribe / cancel | trap |
+| Fake countdown scarcity | lie |
+| Prechecked marketing consent | coercion |
+| Infinite guilt badges | anxiety ≠ retention |
+| Roach motel (easy in, hard out) | hostility |
+
+## Language
+
+- Human language; no API field names in UI (`order_id` → `Nº do pedido`)  
+- Locale-aware dates/numbers when product requires  
+- Banned AI fluff: seamless, next-gen, powerful, unlock, supercharge, elevate, journey, empower…  
+
+## a11y floor
 
-## Onboarding
+- Contrast AA  
+- Focus visible  
+- ≥44px targets mobile  
+- Labels on inputs  
+- Don’t rely on color alone for status  
 
-Value → account → one essential setup → first success. No 12-tooltip tours.
+## Checklist
 
-## Output when reviewing UX
+- [ ] Primary action obvious  
+- [ ] Copy under caps  
+- [ ] Verbs on buttons  
+- [ ] Empty/error/success real  
+- [ ] No dark patterns  
+- [ ] Non-dev language  
+- [ ] First success path short  
 
-Friction list · copy rewrites · state gaps · mobile issues · priority fixes.
+**Be easy to love. Never hard to leave for the wrong reasons.**

package/assets/skills/dme-welcome/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: dme-welcome
+description: >
+  DME 9.69 onboarding / first-run welcome. Value then one setup then first win.
+  Triggers: /dme-welcome, onboarding, first-run, empty state setup, welcome flow.
+---
+
+# DME Welcome 9.69
+
+1. Flow: **value → account → one essential setup → first success**
+2. ≤3 visible steps · thin progress · skip always available
+3. Motion: functional step crossfade 180–200ms
+4. Icons: onboarding strategy (1–3 glyphs) — never 12-tooltip tours
+5. After: empty state = short title + one line + one CTA
+6. Copy caps: step title short · body ≤2 lines · buttons = real verbs
+7. shadcn: Dialog/Sheet or full page · Progress · Button · Input
+
+Banned: guided product tours with tooltip chains, feature-card spam on step 1.
+
+Deliver: step list → copy → motion → implement → subtract.

package/bin/dme.mjs

@@ -1,14 +1,16 @@
 #!/usr/bin/env node
 /**
- * DME Agent CLI — bootstrap + manage Neominimal Identity Engine 7.4
+ * DME Agent CLI 9.69 — navigable TUI · detect-only install · strong AGENTS.md
  */
 
-import { banner, colors as c, info, fail, hr } from "../src/ui.mjs";
-import { installDme, doctor, uninstall } from "../src/install.mjs";
-import { getTargets } from "../src/targets.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { asciiLogo, c, fail, info, hr, showCursor } from "../src/ui.mjs";
+import { installDme, doctor, uninstall, scan, SKILL_NAMES } from "../src/install.mjs";
+import { getTargets } from "../src/targets.mjs";
+import { formatScanReport, getDetectedTargets } from "../src/detect.mjs";
+import { runMainTui, printScanTable } from "../src/tui.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(
@@ -16,7 +18,7 @@ const pkg = JSON.parse(
 );
 
 const args = process.argv.slice(2);
-const cmd = (args[0] || "help").toLowerCase();
+const cmd = (args[0] || "").toLowerCase();
 
 function parseFlags(argv) {
   const flags = {
@@ -24,13 +26,28 @@ function parseFlags(argv) {
     dryRun: false,
     noProject: false,
     force: false,
+    all: false,
+    agentsPolicy: "ask",
+    noTui: false,
+    yes: false,
   };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === "--dry-run") flags.dryRun = true;
     else if (a === "--no-project") flags.noProject = true;
     else if (a === "--force") flags.force = true;
-    else if (a === "--targets" || a === "-t") {
+    else if (a === "--all") {
+      flags.all = true;
+      flags.targets = ["all"];
+    } else if (a === "--no-tui" || a === "--plain") flags.noTui = true;
+    else if (a === "-y" || a === "--yes") {
+      flags.yes = true;
+      flags.agentsPolicy = "merge";
+    } else if (a === "--agents" || a === "--agents-policy") {
+      flags.agentsPolicy = (argv[++i] || "ask").toLowerCase();
+    } else if (a.startsWith("--agents=")) {
+      flags.agentsPolicy = a.slice(9).toLowerCase();
+    } else if (a === "--targets" || a === "-t") {
       const v = argv[++i] || "";
       flags.targets = v.split(",").map((s) => s.trim()).filter(Boolean);
     } else if (a.startsWith("--targets=")) {
@@ -45,100 +62,194 @@ function parseFlags(argv) {
 }
 
 function help() {
-  console.log(banner(pkg.version));
-  console.log(`${c.bold}Usage${c.reset}
-  dme <command> [options]
-
-${c.bold}Commands${c.reset}
-  ${c.yellow}install${c.reset}       Bootstrap DME 7.4 into all AI CLIs (default)
-  ${c.yellow}update${c.reset}        Re-sync assets (alias of install)
-  ${c.yellow}doctor${c.reset}        Verify what is installed
-  ${c.yellow}uninstall${c.reset}     Remove DME files / merged blocks
-  ${c.yellow}list${c.reset}          List supported targets
-  ${c.yellow}path${c.reset}          Print package asset path
-  ${c.yellow}version${c.reset}       Print version
-  ${c.yellow}help${c.reset}          This screen
-
-${c.bold}Options${c.reset}
-  --targets claude,cursor,codex,zed,grok,all
-  --dry-run
-  --no-project          Skip cwd project install
-  --force
-
-${c.bold}Examples${c.reset}
-  ${c.dim}npx dme-agent install${c.reset}
-  ${c.dim}dme install --targets claude,cursor,grok${c.reset}
-  ${c.dim}dme doctor${c.reset}
-
-${c.bold}After install${c.reset}
-  Restart agent sessions. Use skills:
-  /dme-design  /dme-dashboard  /dme-landing  /dme-ux  /dme-shadcn
+  const ver = pkg.version || "9.69.0";
+  console.log(asciiLogo("9.69"));
+  console.log(`${c.bold}${c.brightCyan}DME Agent ${ver}${c.reset}
+${c.dim}Ask palette · motion bible · web vs app · icons · welcome · TUI detect-only${c.reset}
+
+${c.bold}${c.brightCyan}Usage${c.reset}
+  ${c.brightYellow}dme${c.reset}                      interactive TUI
+  ${c.brightYellow}dme${c.reset} <command> [options]
+
+${c.bold}${c.brightCyan}Commands${c.reset}
+  ${c.brightYellow}install${c.reset}       Detect CLIs on this PC → install DME only there
+  ${c.brightYellow}scan${c.reset}          Show which CLIs are detected (detect-only)
+  ${c.brightYellow}doctor${c.reset}        Verify DME install health
+  ${c.brightYellow}uninstall${c.reset}     Remove DME (detected CLIs only)
+  ${c.brightYellow}list${c.reset}          List all supported targets
+  ${c.brightYellow}skills${c.reset}        List installer skill pack
+  ${c.brightYellow}tui${c.reset}           Open navigable menu
+  ${c.brightYellow}path${c.reset}          Print assets path
+  ${c.brightYellow}version${c.reset}       Print version
+  ${c.brightYellow}help${c.reset}          This screen
+
+${c.bold}${c.brightCyan}Options${c.reset}
+  ${c.dim}--targets${c.reset} claude,cursor,grok,detected,all
+  ${c.dim}--all${c.reset}                 Force every surface (ignore detection)
+  ${c.dim}--agents${c.reset} ask|merge|overwrite|skip
+  ${c.dim}-y, --yes${c.reset}             Auto-merge existing AGENTS.md
+  ${c.dim}--dry-run${c.reset}
+  ${c.dim}--no-project${c.reset}          Skip cwd project files
+  ${c.dim}--no-tui${c.reset}              Disable interactive pickers
+
+${c.bold}${c.brightCyan}9.69 skills${c.reset}
+  ${c.dim}${SKILL_NAMES.map((s) => "/" + s).join("  ")}${c.reset}
+
+${c.bold}${c.brightCyan}Examples${c.reset}
+  ${c.dim}npx dme-agent@9.69.0${c.reset}
+  ${c.dim}dme install${c.reset}
+  ${c.dim}dme install --targets claude,cursor${c.reset}
+  ${c.dim}dme install --agents merge -y${c.reset}
+  ${c.dim}dme scan${c.reset}
+
+${c.bold}${c.brightCyan}AGENTS.md${c.reset}
+  Written to each CLI’s ${c.underline}correct path${c.reset}.
+  Prefer assets: AGENTS.md · DME-Agent-v9.69-SYSTEM.md · dme-v9.69.md
+  (falls back to v7.4 names if 9.69 assets not yet present).
+  If the file already exists → TUI asks: Merge / Overwrite / Skip.
 `);
 }
 
+async function doInstall(flags) {
+  const targets =
+    flags.targets.length > 0
+      ? flags.targets
+      : flags.all
+        ? ["all"]
+        : ["detected"];
+
+  await installDme({
+    targets,
+    dryRun: flags.dryRun,
+    force: flags.force,
+    cwdProject: !flags.noProject,
+    agentsPolicy: flags.agentsPolicy,
+    interactive: !flags.noTui && !flags.yes,
+    quiet: flags.yes,
+    pick: !flags.noTui && flags.targets.length === 0 && !flags.all,
+  });
+}
+
 async function main() {
-  const flags = parseFlags(args.slice(1));
+  process.on("exit", () => showCursor());
+  process.on("SIGINT", () => {
+    showCursor();
+    process.exit(130);
+  });
+
+  const flags = parseFlags(cmd ? args.slice(1) : args);
+
+  if (!cmd) {
+    if (process.stdin.isTTY && process.stdout.isTTY && !flags.noTui) {
+      await runMainTui({
+        version: pkg.version,
+        onInstall: () => doInstall({ ...flags, targets: [] }),
+        onDoctor: () => doctor(),
+        onUninstall: () => uninstall({ all: flags.all }),
+        onScan: () => {
+          printScanTable(formatScanReport());
+          const n = getDetectedTargets().length;
+          console.log(
+            info(`${n} CLI(s) will receive DME on install (detect-only)`)
+          );
+          console.log("");
+        },
+      });
+      return;
+    }
+    help();
+    return;
+  }
 
   switch (cmd) {
     case "i":
     case "install":
     case "bootstrap":
     case "update":
-    case "init": {
-      console.log(banner(pkg.version));
-      console.log(info("Bootstrapping Neominimal Identity Engine…"));
-      console.log(hr());
-      await installDme({
-        targets: flags.targets.length ? flags.targets : ["all"],
-        dryRun: flags.dryRun,
-        force: flags.force,
-        cwdProject: !flags.noProject,
-      });
+    case "init":
+      await doInstall(flags);
       break;
-    }
+
+    case "scan":
+    case "detect":
+      scan();
+      break;
+
     case "doctor":
     case "status":
     case "check":
-      console.log(banner(pkg.version));
       doctor();
       break;
+
     case "uninstall":
     case "remove":
-      console.log(banner(pkg.version));
-      uninstall();
+      uninstall({ all: flags.all });
+      break;
+
+    case "skills":
+      console.log(asciiLogo("9.69"));
+      console.log(hr());
+      for (const s of SKILL_NAMES) {
+        console.log(`  ${c.brightYellow}/${s}${c.reset}`);
+      }
+      console.log("");
+      console.log(info(`${SKILL_NAMES.length} skills in installer pack`));
+      console.log("");
+      break;
+
+    case "tui":
+    case "menu":
+    case "ui":
+      await runMainTui({
+        version: pkg.version,
+        onInstall: () => doInstall({ ...flags, targets: [] }),
+        onDoctor: () => doctor(),
+        onUninstall: () => uninstall({ all: flags.all }),
+        onScan: () => scan(),
+      });
       break;
+
     case "list":
     case "targets":
-      console.log(banner(pkg.version));
+      console.log(asciiLogo("9.69"));
+      console.log(hr());
       for (const t of getTargets()) {
         console.log(
-          `  ${c.yellow}${t.id.padEnd(14)}${c.reset} ${t.name}${t.optional ? c.dim + " (optional)" + c.reset : ""}`
+          `  ${c.brightYellow}${t.id.padEnd(14)}${c.reset} ${c.brightWhite}${t.name}${c.reset}`
         );
+        if (t.agentsMd) {
+          console.log(`  ${"".padEnd(14)} ${c.dim}AGENTS → ${t.agentsMd}${c.reset}`);
+        }
       }
       console.log("");
       break;
+
     case "path":
     case "assets":
       console.log(path.join(__dirname, "..", "assets"));
       break;
+
     case "version":
     case "-v":
     case "--version":
       console.log(pkg.version);
       break;
+
     case "help":
     case "-h":
     case "--help":
+      help();
+      break;
+
     default:
-      if (cmd !== "help" && cmd !== "-h" && cmd !== "--help") {
-        console.log(fail(`Unknown command: ${cmd}`));
-      }
+      console.log(fail(`Unknown command: ${cmd}`));
       help();
-      process.exit(cmd === "help" || cmd === "-h" || cmd === "--help" ? 0 : 1);
+      process.exit(1);
   }
 }
 
 main().catch((e) => {
+  showCursor();
   console.error(fail(e?.stack || String(e)));
   process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dme-agent",
-  "version": "7.4.1",
-  "description": "DME Agent 7.4 — Neominimal Identity Engine. Bootstrap design system prompts, skills & UX doctrine across Claude, Codex, Cursor, Zed, Grok, Windsurf and more.",
+  "version": "9.69.0",
+  "description": "DME Agent 9.69 — Neominimal Identity Engine. Detect-only bootstrap + TUI. Ask palette · motion bible · web vs app · icons · welcome.",
   "type": "module",
   "bin": {
     "dme": "bin/dme.mjs",
@@ -34,13 +34,18 @@
     "neominimal",
     "dashboard",
     "landing-page",
-    "bootstrap"
+    "bootstrap",
+    "tui",
+    "motion",
+    "icons",
+    "electron",
+    "tauri"
   ],
   "author": "AnThophicous / brennoleondesouza",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/brennoleondesouza/dme-agent"
+    "url": "git+https://github.com/brennoleondesouza/dme-agent.git"
   },
   "homepage": "https://www.npmjs.com/package/dme-agent",
   "engines": {