npm - code-ai-installer - Versions diffs - 1.3.0 → 1.4.0 - Mend

code-ai-installer 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1293) hide show

package/locales/en/.agents/a11y_baseline/SKILL.md DELETED Viewed

@@ -1,260 +0,0 @@
----
-name: a11y_baseline
-description: Minimum baseline accessibility for web UI — keyboard navigation, focus management, form labels, ARIA for interactive components, error messages.
----
-# Skill: A11y Baseline
-Minimal requirements accessibility for MVP. For testing → `$qa_ui_a11y_smoke`.
-**Sections:**
-1. [Requirements by WCAG](#1-requirements)
-2. [Component A11y Table](#2-components)
-3. [Code Examples](#3-examples)
-4. [Verification](#4-verification)
-5. [Output Template](#5-output)
----
-## 1. Requirements by WCAG 2.1 AA
-### 1.1 Keyboard (WCAG 2.1.1, 2.1.2)
-| # | Requirement | WCAG | Severity |
-|---|------------|------|----------|
-| A-01 | All interactive elements reachable via Tab | 2.1.1 (A) | 🔴 P0 |
-| A-02 | No keyboard traps (always can Tab out) | 2.1.2 (A) | 🔴 P0 |
-| A-03 | Focus order is logical (DOM order matches visual) | 2.4.3 (A) | 🟠 P1 |
-| A-04 | Shortcuts don't conflict with assistive tech | 2.1.4 (A) | 🟡 P2 |
-### 1.2 Focus (WCAG 2.4.7)
-| # | Requirement | WCAG | Severity |
-|---|------------|------|----------|
-| A-05 | Visible focus indicator on all interactive elements | 2.4.7 (AA) | 🔴 P0 |
-| A-06 | Focus indicator ≥ 2px in contrast | 1.4.11 (AA) | 🟠 P1 |
-| A-07 | Modal: focus moves inside on open | — (UX) | 🟠 P1 |
-| A-08 | Modal: focus returns to trigger on close | — (UX) | 🟠 P1 |
-| A-09 | No `outline: none` without `:focus-visible` replacement | — | 🔴 P0 |
-### 1.3 Forms (WCAG 1.3.1, 3.3.x)
-| # | Requirement | WCAG | Severity |
-|---|------------|------|----------|
-| A-10 | Every input has `<label>` or `aria-label` | 1.3.1 (A) | 🔴 P0 |
-| A-11 | Required fields have `aria-required="true"` or visual marker | 1.3.1 (A) | 🟠 P1 |
-| A-12 | Error messages associated via `aria-describedby` | 3.3.1 (A) | 🟠 P1 |
-| A-13 | Error messages are descriptive (not just "Invalid") | 3.3.3 (AA) | 🟠 P1 |
-| A-14 | Form submission feedback announced (toast + aria-live) | 4.1.3 (AA) | 🟠 P1 |
-### 1.4 Content (WCAG 1.1.1, 1.3.1)
-| # | Requirement | WCAG | Severity |
-|---|------------|------|----------|
-| A-15 | Images have `alt` text (or `alt=""` for decorative) | 1.1.1 (A) | 🟠 P1 |
-| A-16 | One `<h1>` per page with logical heading hierarchy | 1.3.1 (A) | 🟠 P1 |
-| A-17 | Semantic HTML used (`<button>`, `<nav>`, `<main>`) | 1.3.1 (A) | 🟠 P1 |
-| A-18 | Language attribute set (`<html lang="en">`) | 3.1.1 (A) | 🟡 P2 |
-### 1.5 Contrast & Visual (WCAG 1.4.x)
-| # | Requirement | WCAG | Severity |
-|---|------------|------|----------|
-| A-19 | Text contrast ≥ 4.5:1 (normal) / 3:1 (large text ≥ 18px) | 1.4.3 (AA) | 🟠 P1 |
-| A-20 | Non-text UI contrast ≥ 3:1 (borders, icons) | 1.4.11 (AA) | 🟡 P2 |
-| A-21 | Color is not the only means to convey meaning | 1.4.1 (A) | 🟠 P1 |
-| A-22 | `prefers-reduced-motion` respected (or opt-in animations) | 2.3.3 (AAA) | 🟡 P2 |
----
-## 2. Component A11y Table
-### Required ARIA per component type
-| Component | Element | Required ARIA | Keyboard |
-|-----------|---------|--------------|----------|
-| **Button** | `<button>` | — (native) | Enter/Space → activate |
-| **Link** | `<a href>` | — (native) | Enter → navigate |
-| **Input** | `<input>` | `aria-invalid`, `aria-describedby` | — |
-| **Select** | `<select>` or `[role="listbox"]` | `aria-expanded`, `aria-selected` | Arrow keys |
-| **Checkbox** | `<input type="checkbox">` | — (native) | Space → toggle |
-| **Switch** | `[role="switch"]` | `aria-checked` | Space → toggle |
-| **Tabs** | `[role="tablist"]` + `[role="tab"]` | `aria-selected`, `aria-controls` | Arrow keys → navigate |
-| **Modal** | `[role="dialog"]` | `aria-modal="true"`, `aria-labelledby` | Escape → close, focus trap |
-| **Toast** | `[role="status"]` or `[aria-live="polite"]` | — | Auto-announced |
-| **Tooltip** | `[role="tooltip"]` | `aria-describedby` on trigger | Escape → dismiss |
-| **Spinner** | — | `aria-busy="true"` on container | — |
-| **Skeleton** | — | `aria-hidden="true"` | — |
-| **Table** | `<table>` | `<th scope="col/row">` | — |
-| **Dropdown** | `[role="menu"]` | `aria-expanded`, `aria-haspopup` | Arrow keys, Enter, Escape |
----
-## 3. Code Examples
-### Focus management: Modal
-```jsx
-// ✅ Correct modal focus management
-function Modal({ isOpen, onClose, children }) {
-  const closeRef = useRef(null);
-  const triggerRef = useRef(null);
-  useEffect(() => {
-    if (isOpen) {
-      closeRef.current?.focus(); // Focus moves inside modal
-    } else {
-      triggerRef.current?.focus(); // Focus returns to trigger
-    }
-  }, [isOpen]);
-  return (
-    <div
-      role="dialog"
-      aria-modal="true"
-      aria-labelledby="modal-title"
-    >
-      <h2 id="modal-title">Confirm Delete</h2>
-      {children}
-      <button ref={closeRef} onClick={onClose}>Cancel</button>
-    </div>
-  );
-}
-```
-### Form field with error
-```jsx
-// ✅ Correct form field a11y
-function FormField({ id, label, error, required, children }) {
-  const errorId = `${id}-error`;
-  return (
-    <div>
-      <label htmlFor={id}>
-        {label}
-        {required && <span aria-hidden="true"> *</span>}
-      </label>
-      {React.cloneElement(children, {
-        id,
-        'aria-required': required,
-        'aria-invalid': !!error,
-        'aria-describedby': error ? errorId : undefined,
-      })}
-      {error && (
-        <p id={errorId} role="alert" className="error-text">
-          {error}
-        </p>
-      )}
-    </div>
-  );
-}
-```
-### Focus visible CSS
-```css
-/* ✅ Correct focus management */
-/* Remove default but keep for keyboard users */
-*:focus {
-  outline: none;
-}
-*:focus-visible {
-  outline: 2px solid var(--color-primary);
-  outline-offset: 2px;
-}
-/* ❌ DON'T: Remove focus for everyone */
-*:focus {
-  outline: none; /* breaks keyboard navigation! */
-}
-```
-### Toast with aria-live
-```jsx
-// ✅ Toast that screen readers announce
-function ToastContainer({ toasts }) {
-  return (
-    <div aria-live="polite" aria-atomic="true">
-      {toasts.map(toast => (
-        <div key={toast.id} role="status">
-          {toast.message}
-        </div>
-      ))}
-    </div>
-  );
-}
-```
----
-## 4. Verification
-### Automated tools
-| Tool | What it checks | How to run |
-|------|---------------|-----------|
-| **axe DevTools** | WCAG violations, missing ARIA | Browser extension → Scan |
-| **Lighthouse a11y** | Overall a11y score (target ≥ 90) | DevTools → Lighthouse |
-| **eslint-plugin-jsx-a11y** | JSX a11y rules in code | `npm install eslint-plugin-jsx-a11y` |
-### Manual checks
-| Check | How |
-|-------|-----|
-| Keyboard navigation | Tab through entire page without mouse |
-| Focus visible | Every focused element has visible outline |
-| Screen reader | Test with NVDA/VoiceOver |
-| Color contrast | axe DevTools or Lighthouse |
-### Acceptance criteria for Tester
-```markdown
-- [ ] All P0 interactive flows completable via keyboard
-- [ ] All form fields have labels (visible or aria-label)
-- [ ] Modals trap focus and return on close
-- [ ] Error messages linked to fields (aria-describedby)
-- [ ] No `outline: none` without focus-visible replacement
-- [ ] Lighthouse a11y score ≥ 90
-```
----
-## 5. Output Template
-```markdown
-# A11y Baseline: <Project/Feature>
-**Date:** YYYY-MM-DD
-**Author:** UX/UI Designer Agent
-**WCAG Target:** 2.1 AA
-## Requirements Summary
-| Category | Total | P0 | P1 | P2 |
-|----------|:-----:|:---:|:---:|:---:|
-| Keyboard | 4 | 2 | 1 | 1 |
-| Focus | 5 | 2 | 3 | 0 |
-| Forms | 5 | 1 | 4 | 0 |
-| Content | 4 | 0 | 3 | 1 |
-| Visual | 4 | 0 | 2 | 2 |
-| **Total** | **22** | **5** | **13** | **4** |
-## Component A11y Requirements
-<section 2 table>
-## Acceptance Criteria for Tester
-<section 4 checklist>
-## Notes / Exceptions
-- <any project-specific exceptions>
-```
----
-## See also
-- `$qa_ui_a11y_smoke` — a11y smoke testing
-- `$ui_inventory` — component inventory (includes a11y notes)
-- `$styling_css_stack` — CSS a11y patterns (focus-visible, prefers-reduced-motion)
-- `$ux_spec` — UX Spec (screens with states)

package/locales/en/.agents/adr_log/SKILL.md DELETED Viewed

@@ -1,369 +0,0 @@
----
-name:adr_log
-description: Record key architectural decisions (ADR) with trade-offs — Pros/Cons/Alternatives/Decision, status and date.
----
-#Skill: ADR Log
-Format and examples for Architectural Decision Records.
-**Sections:**
-1. [When create ADR](#1-when)
-2. [Format (mandatory)](#2-format)
-3. [Naming Convention](#3-naming)
-4. [Examples ADR](#4-examples)
-5. [Decision Matrix](#5-decision-matrix)
-6. [Lifecycle](#6-lifecycle)
-7. [Anti-patterns](#7-anti-patterns)
----
-## 1. When create ADR
-Create ADR for **each non-trivial choice** — if in 6 months someone asks "why like this?":
-| Category | Examples |
-|-----------|---------|
-| **Database** | DBMS choice, embed vs reference, sharding strategy |
-| **Auth** | JWT vs sessions, cookie vs header, OAuth flow |
-| **API Design** | REST vs GraphQL, versioning, error format |
-| **Architecture** | Monolith vs microservices, layering, module boundaries |
-| **Infrastructure** | Docker vs K8s, CDN, reverse proxy, HTTPS strategy |
-| **Integration** | Wix SDK choice, payment provider, email service |
-| **State** | Zustand vs Redux vs Context, server state (React Query) |
-| **Styling** | CSS Modules vs Tailwind vs styled-components |
-| **Testing** | Test runner, coverage thresholds, mock strategy |
-| **Error handling** | Error format, retry policy, circuit breaker |
----
-## 2. Format (mandatory)
-```markdown
-# ADR-XXX: <Short decision title>
-## Status
-Proposed | Accepted | Deprecated | Superseded by ADR-YYY
-## Date
-YYYY-MM-DD
-## Context
-<Why is this needed? What constraints? What hurts?>
-- Current situation
-- Requirements / constraints
-- What happens if it is not solved
-##Decision
-<What we chose and how exactly we will do it>
-## Consequences
-### Positive
-- ...
-- ...
-###Negative
-- ...
-- ...
-### Risks
-- ... (and how we mitigate)
-## Alternatives Considered
-### Option A: <title>
-- ✅ Pros: ...
-- ❌ Cons: ...
-- 💡 Why rejected: ...
-### Option B: <title>
-- ✅ Pros: ...
-- ❌ Cons: ...
-- 💡 Why rejected: ...
-## References
-- PRD section / UX Spec / ticket
-- External docs / articles
-- Related ADRs: ADR-XXX
-```
----
-## 3. Naming Convention
-| Rule | Example |
-|---------|--------|
-| Number: 3-digit, with leading zeros | ADR-001, ADR-042 |
-| Title: action + object | "Use MongoDB as primary database" |
-| File: `ADR-XXX-kebab-case.md` | `ADR-001-use-mongodb.md` |
-| Directory: `docs/architecture/adr/` | — |
-| Chronological order | New ADR = next number |
----
-## 4. Examples ADR
-### ADR-001: Use MongoDB as primary database
-```markdown
-# ADR-001: Use MongoDB as primary database
-## Status
-Accepted
-##Date
-2025-06-15
-##Context
-Smart Cart Rescue needs persistent storage for installations, settings,
-and coupons. Requirements:
-- Flexible schema (settings structure varies per template)
-- Low operational overhead (small team)
-- Good Node.js ecosystem support
-- No complex joins needed (data is per-installation)
-##Decision
-Use MongoDB 7 with Mongoose ODM.
-- Single database, collections: installations, settings, coupons
-- Hosted via Docker (dev) / MongoDB Atlas (production)
-## Consequences
-### Positive
-- Flexible schema fits varying template settings
-- Excellent Mongoose ecosystem (validators, middleware, lean queries)
-- Easy Docker setup for local development
-- Native JSON — minimal serialization overhead
-###Negative
-- No ACID transactions across collections (need replica set)
-- No joins — must denormalize or do application-level joins
-- Schema discipline required (strict mode + Zod validation)
-### Risks
-- Schema drift without validation → mitigated by strict: 'throw'
-- 16MB document limit → mitigated by reference strategy for unbounded arrays
-## Alternatives Considered
-### Option A: PostgreSQL
-- ✅ ACID, complex queries, strong typing
-- ❌ Schema migrations more complex for flexible settings
-- ❌ JSON column less ergonomic than native MongoDB documents
-- 💡 Overkill for current use case (no joins, no complex queries)
-### Option B: SQLite
-- ✅ Zero infrastructure, file-based
-- ❌ No concurrent writes in Docker
-- ❌ No production scaling path
-- 💡 Too limiting for multi-service architecture
-## References
-- PRD: Data requirements section
-- Related: ADR-002 (Mongoose strict mode)
-```
----
-### ADR-018: Use Wix ImageViewer for dashboard images
-```markdown
-# ADR-018: Use Wix ImageViewer for dashboard images
-##Status
-Accepted
-##Date
-2025-12-20
-## Context
-Dashboard needs to display template preview images.
-The app runs inside Wix iframe where standard <img> tags may have
-CORS issues with Wix media URLs (wixstatic.com).
-## Decision
-Use WDS (Wix Design System) ImageViewer component for all
-dashboard images instead of native <img> tags.
-## Consequences
-### Positive
-- Handles Wix media URLs natively (no CORS issues)
-- Consistent with Wix design system (visual parity)
-- Built-in loading states and error handling
-### Negative
-- Dependency on WDS component library
-- Different API than standard <img> (onLoad, src format)
-## Alternatives Considered
-### Option A: Native <img> with proxy
-- ✅ Simple, no dependency
-- ❌ CORS errors with wixstatic.com
-- ❌ Need custom proxy endpoint
-- 💡 Unnecessary complexity
-## References
-- Bug: Dashboard images not loading (blank src)
-- Wix Design System docs: ImageViewer component
-```
----
-### ADR-019: CSS overflow containment for popup templates
-```markdown
-# ADR-019: CSS overflow containment for popup
-## Status
-Accepted
-## Date
-2025-12-20
-## Context
-Popup templates render inside Wix embedded script.
-CSS overflow from popup elements leaks outside the container,
-causing scrollbars on the Wix page.
-## Decision
-Apply containment strategy:
-1. `overflow: hidden` on popup container
-2. `contain: layout style` on root widget element
-3. `box-sizing: border-box` on all popup children
-## Consequences
-### Positive
-- No visual leaking outside container
-- No unexpected scrollbars on host page
-- Each template isolated
-### Negative
-- Must test each template for clipping issues
-- Shadow effects near edges may be cut off
-## Alternatives Considered
-### Option A: Shadow DOM
-- ✅ Complete style isolation
-- ❌ Complex to implement for dynamic templates
-- ❌ Limited shadow DOM support for legacy browsers
-- 💡 Overkill for current 3-template scope
-## References
-- Bug: Scrollbar appearing on Wix site when popup opens
-- Related: ADR-018 (ImageViewer)
-```
----
-## 5. Decision Matrix
-For complex decisions with 3+ alternative use weighted matrix:
-```markdown
-## Decision Matrix: State Management
-### Criteria (weighted)
-| Criteria | Weight | Description |
-|----------|--------|-------------|
-| Simplicity | 3 | Learning curve, boilerplate |
-| Performance | 2 | Re-render efficiency |
-| DevTools | 1 | Debugging experience |
-| Ecosystem | 1 | Community, plugins |
-| Bundle size | 2 | KB added |
-### Scoring (1-5, higher = better)
-| Option | Simplicity (×3) | Performance (×2) | DevTools (×1) | Ecosystem (×1) | Bundle (×2) | **Total** |
-|--------|:---:|:---:|:---:|:---:|:---:|:---:|
-| **Zustand** | 5 (15) | 4 (8) | 4 (4) | 3 (3) | 5 (10) | **40** |
-| Redux Toolkit | 3 (9) | 4 (8) | 5 (5) | 5 (5) | 3 (6) | **33** |
-| Context + useReducer | 4 (12) | 2 (4) | 3 (3) | 5 (5) | 5 (10) | **34** |
-| Jotai | 4 (12) | 5 (10) | 3 (3) | 2 (2) | 5 (10) | **37** |
-### Decision
-Zustand wins (40 points). Best simplicity + performance + bundle size.
-```
----
-## 6. Lifecycle
-```
-Proposed → Accepted → [Active use]
-                         ↓
-                    Deprecated (if better solution found)
-                         ↓
-                    Superseded by ADR-YYY
-```
-| Status | Meaning |
-|--------|---------|
-| **Proposed** | Decision is proposed, waiting for review |
-| **Accepted** | Decision is accepted and applied |
-| **Deprecated** | Decision is deprecated, but the code still uses it |
-| **Superseded** | Superseded by another ADR (specify link) |
-### Supersedes/Superseded-by
-```markdown
-# ADR-025: Migrate from CSS Modules to Tailwind
-## Status
-Accepted (Supersedes ADR-008)
----
-# ADR-008: Use CSS Modules for component styling
-## Status
-Superseded by ADR-025
-```
----
-## 7. Anti-patterns
-| ❌ Anti-pattern | ✅ Decision |
-|----------------|-----------|
-| ADR without Alternatives | Always at least 2 alternatives |
-| "We chose X because it's popular" | Concrete pros/cons by project criteria |
-| 500-line ADR | Short and concrete: max 50-80 lines |
-| ADR retroactively (a month later) | Create ADR in the moment the decision is made |
-| No cross-references | Links to the PRD, related ADRs, tickets |
-| No Negative consequences | Every decision has trade-offs |
-| "Alternatives: none" | If there are no alternatives — revisit the scope question |
----
-## Deliverables
-| Artifact | Format | Where |
-|---------|--------|-----|
-| ADR record | Markdown (format above) | `docs/architecture/adr/ADR-XXX-name.md` |
-| ADR index | Table of contents | `docs/architecture/adr/README.md` |
-### ADR Index format
-```markdown
-# Architecture Decision Records
-| # | Title | Status | Date |
-|---|-------|--------|------|
-| ADR-001 | Use MongoDB as primary database | Accepted | 2025-06-15 |
-| ADR-008 | Use CSS Modules for styling | Superseded by ADR-025 | 2025-07-01 |
-| ADR-018 | Use WDS ImageViewer | Accepted | 2025-12-20 |
-| ADR-019 | CSS overflow containment | Accepted | 2025-12-20 |
-| ADR-025 | Migrate to Tailwind | Accepted | 2026-01-15 |
-```
----
-## See also
-- `$architecture_doc` — Architecture Document (ADR decisions referenced inline)
-- `$current_state_analysis` — audit before new ADRs
-- `$system_design_checklist` — checklist design completeness

package/locales/en/.agents/adr_log/agents/claude.json DELETED Viewed

@@ -1,18 +0,0 @@
-{
-  "name": "adr_log",
-  "display_name": "ADR-XXX: <Short decision title>",
-  "description": "Record key architectural decisions (ADR) with trade-offs — Pros/Cons/Alternatives/Decision, status and date.",
-  "default_prompt": "Use $adr_log when the task matches the \"ADR-XXX: <Short decision title>\" skill.",
-  "triggers": [
-    "adr_log",
-    "adr log",
-    "ADR-XXX: <Short decision title>",
-    "Record key architectural decisions (ADR) with trade-offs — Pros/Cons/Alternatives/Decision, status and date"
-  ],
-  "capabilities": [
-    "adr",
-    "log"
-  ],
-  "tools": [],
-  "implicit_invocation": true
-}

package/locales/en/.agents/adr_log/agents/copilot.json DELETED Viewed

@@ -1,18 +0,0 @@
-{
-  "name": "adr_log",
-  "display_name": "ADR-XXX: <Short decision title>",
-  "description": "Record key architectural decisions (ADR) with trade-offs — Pros/Cons/Alternatives/Decision, status and date.",
-  "default_prompt": "Use $adr_log when the task matches the \"ADR-XXX: <Short decision title>\" skill.",
-  "triggers": [
-    "adr_log",
-    "adr log",
-    "ADR-XXX: <Short decision title>",
-    "Record key architectural decisions (ADR) with trade-offs — Pros/Cons/Alternatives/Decision, status and date"
-  ],
-  "capabilities": [
-    "adr",
-    "log"
-  ],
-  "tools": [],
-  "implicit_invocation": true
-}

package/locales/en/.agents/adr_log/agents/gemini.json DELETED Viewed

@@ -1,18 +0,0 @@
-{
-  "name": "adr_log",
-  "display_name": "ADR-XXX: <Short decision title>",
-  "description": "Record key architectural decisions (ADR) with trade-offs — Pros/Cons/Alternatives/Decision, status and date.",
-  "default_prompt": "Use $adr_log when the task matches the \"ADR-XXX: <Short decision title>\" skill.",
-  "triggers": [
-    "adr_log",
-    "adr log",
-    "ADR-XXX: <Short decision title>",
-    "Record key architectural decisions (ADR) with trade-offs — Pros/Cons/Alternatives/Decision, status and date"
-  ],
-  "capabilities": [
-    "adr",
-    "log"
-  ],
-  "tools": [],
-  "implicit_invocation": true
-}

package/locales/en/.agents/adr_log/agents/openai.yaml DELETED Viewed

@@ -1,8 +0,0 @@
-interface:
-  display_name: "ADR-XXX: <Short decision title>"
-  short_description: "Record key architectural decisions (ADR) with trade-offs — Pros/Cons/Alternatives/Decision, sta…"
-  default_prompt: "Use $adr_log when the task matches the \"ADR-XXX: <Short decision title>\" skill."
-dependencies:
-  tools: []
-policy:
-  allow_implicit_invocation: true