dme-agent 7.4.2 → 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,13 +1,13 @@
 #!/usr/bin/env node
 /**
- * DME Agent CLI — navigable TUI · detect-only install · strong AGENTS.md
+ * DME Agent CLI 9.69 — navigable TUI · detect-only install · strong AGENTS.md
  */
 
 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 } from "../src/install.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";
@@ -27,7 +27,7 @@ function parseFlags(argv) {
     noProject: false,
     force: false,
     all: false,
-    agentsPolicy: "ask", // ask | merge | overwrite | skip
+    agentsPolicy: "ask",
     noTui: false,
     yes: false,
   };
@@ -39,13 +39,11 @@ function parseFlags(argv) {
     else if (a === "--all") {
       flags.all = true;
       flags.targets = ["all"];
-    }
-    else if (a === "--no-tui" || a === "--plain") flags.noTui = true;
+    } 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") {
+    } else if (a === "--agents" || a === "--agents-policy") {
       flags.agentsPolicy = (argv[++i] || "ask").toLowerCase();
     } else if (a.startsWith("--agents=")) {
       flags.agentsPolicy = a.slice(9).toLowerCase();
@@ -64,17 +62,22 @@ function parseFlags(argv) {
 }
 
 function help() {
-  console.log(asciiLogo(pkg.version));
-  console.log(`${c.bold}${c.brightCyan}Usage${c.reset}
+  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
+  ${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
@@ -89,8 +92,11 @@ ${c.bold}${c.brightCyan}Options${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${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}
@@ -98,6 +104,8 @@ ${c.bold}${c.brightCyan}Examples${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.
 `);
 }
@@ -123,7 +131,6 @@ async function doInstall(flags) {
 }
 
 async function main() {
-  // ensure cursor restored on crash
   process.on("exit", () => showCursor());
   process.on("SIGINT", () => {
     showCursor();
@@ -132,7 +139,6 @@ async function main() {
 
   const flags = parseFlags(cmd ? args.slice(1) : args);
 
-  // No command → TUI if tty, else help + scan hint
   if (!cmd) {
     if (process.stdin.isTTY && process.stdout.isTTY && !flags.noTui) {
       await runMainTui({
@@ -180,6 +186,17 @@ async function main() {
       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":
@@ -194,7 +211,7 @@ async function main() {
 
     case "list":
     case "targets":
-      console.log(asciiLogo(pkg.version));
+      console.log(asciiLogo("9.69"));
       console.log(hr());
       for (const t of getTargets()) {
         console.log(

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dme-agent",
-  "version": "7.4.2",
-  "description": "DME Agent 7.4.2 — Neominimal Identity Engine. Detect-only bootstrap + navigable TUI for Claude, Codex, Cursor, Zed, Grok 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",
@@ -35,7 +35,11 @@
     "dashboard",
     "landing-page",
     "bootstrap",
-    "tui"
+    "tui",
+    "motion",
+    "icons",
+    "electron",
+    "tauri"
   ],
   "author": "AnThophicous / brennoleondesouza",
   "license": "MIT",