devflow-kit 1.8.3 → 2.0.0

package/dist/utils/safe-delete-install.js

@@ -1,191 +0,0 @@
-import { promises as fs } from 'fs';
-import * as path from 'path';
-const START_MARKER = '# >>> DevFlow safe-delete >>>';
-const END_MARKER = '# <<< DevFlow safe-delete <<<';
-/** Bump this when the safe-delete block changes. */
-export const SAFE_DELETE_BLOCK_VERSION = 2;
-/**
- * Generate the safe-delete shell function block with markers.
- * Returns null for unsupported shells.
- */
-export function generateSafeDeleteBlock(shell, platform, trashCommand) {
-    if (shell === 'unknown')
-        return null;
-    if (shell === 'bash' || shell === 'zsh') {
-        const cmd = trashCommand ?? 'trash';
-        return [
-            START_MARKER,
-            `# v${SAFE_DELETE_BLOCK_VERSION}`,
-            `rm() {`,
-            `  local files=()`,
-            `  for arg in "$@"; do`,
-            `    [[ "$arg" =~ ^- ]] || files+=("$arg")`,
-            `  done`,
-            `  local existing=()`,
-            `  for f in "\${files[@]}"; do`,
-            `    [ -e "$f" ] || [ -L "$f" ] && existing+=("$f")`,
-            `  done`,
-            `  if (( \${#existing[@]} > 0 )); then`,
-            `    ${cmd} "\${existing[@]}"`,
-            `  fi`,
-            `}`,
-            `command() {`,
-            `  if [[ "$1" == "rm" ]]; then`,
-            `    shift; rm "$@"`,
-            `  else`,
-            `    builtin command "$@"`,
-            `  fi`,
-            `}`,
-            END_MARKER,
-        ].join('\n');
-    }
-    if (shell === 'fish') {
-        const cmd = trashCommand ?? 'trash';
-        return [
-            START_MARKER,
-            `# v${SAFE_DELETE_BLOCK_VERSION}`,
-            `function rm --description "Safe delete via trash"`,
-            `  set -l files`,
-            `  for arg in $argv`,
-            `    if not string match -q -- '-*' $arg`,
-            `      set files $files $arg`,
-            `    end`,
-            `  end`,
-            `  set -l existing`,
-            `  for f in $files`,
-            `    if test -e $f; or test -L $f`,
-            `      set existing $existing $f`,
-            `    end`,
-            `  end`,
-            `  if test (count $existing) -gt 0`,
-            `    ${cmd} $existing`,
-            `  end`,
-            `end`,
-            END_MARKER,
-        ].join('\n');
-    }
-    if (shell === 'powershell') {
-        if (platform === 'win32') {
-            return [
-                START_MARKER,
-                `# v${SAFE_DELETE_BLOCK_VERSION}`,
-                `if (Get-Alias rm -ErrorAction SilentlyContinue) {`,
-                `  Remove-Alias rm -Force -Scope Global`,
-                `}`,
-                `function rm {`,
-                `  $files = $args | Where-Object { $_ -notlike '-*' }`,
-                `  if ($files) {`,
-                `    Add-Type -AssemblyName Microsoft.VisualBasic`,
-                `    foreach ($f in $files) {`,
-                `      $p = Resolve-Path $f -ErrorAction SilentlyContinue`,
-                `      if ($p) {`,
-                `        if (Test-Path $p -PathType Container) {`,
-                `          [Microsoft.VisualBasic.FileIO.FileSystem]::DeleteDirectory(`,
-                `            $p, 'OnlyErrorDialogs', 'SendToRecycleBin')`,
-                `        } else {`,
-                `          [Microsoft.VisualBasic.FileIO.FileSystem]::DeleteFile(`,
-                `            $p, 'OnlyErrorDialogs', 'SendToRecycleBin')`,
-                `        }`,
-                `      }`,
-                `    }`,
-                `  }`,
-                `}`,
-                END_MARKER,
-            ].join('\n');
-        }
-        // macOS/Linux PowerShell
-        const cmd = trashCommand ?? 'trash';
-        return [
-            START_MARKER,
-            `# v${SAFE_DELETE_BLOCK_VERSION}`,
-            `if (Get-Alias rm -ErrorAction SilentlyContinue) {`,
-            `  Remove-Alias rm -Force -Scope Global`,
-            `}`,
-            `function rm {`,
-            `  $files = $args | Where-Object { $_ -notlike '-*' }`,
-            `  $existing = $files | Where-Object { Test-Path $_ }`,
-            `  if ($existing) { & ${cmd} @existing }`,
-            `}`,
-            END_MARKER,
-        ].join('\n');
-    }
-    return null;
-}
-/**
- * Check if the safe-delete block is already installed in a profile file.
- */
-export async function isAlreadyInstalled(profilePath) {
-    try {
-        const content = await fs.readFile(profilePath, 'utf-8');
-        return content.includes(START_MARKER) && content.includes(END_MARKER);
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Append the safe-delete block to a profile file.
- * Creates parent directories and the file if they don't exist.
- */
-export async function installToProfile(profilePath, block) {
-    await fs.mkdir(path.dirname(profilePath), { recursive: true });
-    let existing = '';
-    try {
-        existing = await fs.readFile(profilePath, 'utf-8');
-    }
-    catch {
-        // File doesn't exist yet — will be created
-    }
-    const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n\n' : '\n';
-    const content = existing.length > 0 ? existing + separator + block + '\n' : block + '\n';
-    await fs.writeFile(profilePath, content, 'utf-8');
-}
-/**
- * Extract the installed safe-delete block version from a profile file.
- * Returns 0 (not installed), 1 (legacy block without version stamp), or N (versioned block).
- */
-export async function getInstalledVersion(profilePath) {
-    try {
-        const content = await fs.readFile(profilePath, 'utf-8');
-        const startIdx = content.indexOf(START_MARKER);
-        if (startIdx === -1)
-            return 0;
-        const afterMarker = content.slice(startIdx + START_MARKER.length);
-        const match = afterMarker.match(/^\n# v(\d+)/);
-        return match ? parseInt(match[1], 10) : 1;
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * Remove the safe-delete block from a profile file.
- * Returns true if the block was found and removed, false otherwise.
- * For fish function files, deletes the file if it becomes empty.
- */
-export async function removeFromProfile(profilePath) {
-    let content;
-    try {
-        content = await fs.readFile(profilePath, 'utf-8');
-    }
-    catch {
-        return false;
-    }
-    const startIdx = content.indexOf(START_MARKER);
-    const endIdx = content.indexOf(END_MARKER);
-    if (startIdx === -1 || endIdx === -1)
-        return false;
-    const before = content.slice(0, startIdx);
-    const after = content.slice(endIdx + END_MARKER.length);
-    // Clean up surrounding whitespace
-    const cleaned = (before.trimEnd() + after.trimStart()).trim();
-    if (cleaned.length === 0) {
-        // File is empty after removal — delete it (fish function files)
-        await fs.unlink(profilePath);
-    }
-    else {
-        await fs.writeFile(profilePath, cleaned + '\n', 'utf-8');
-    }
-    return true;
-}
-//# sourceMappingURL=safe-delete-install.js.map

package/dist/utils/safe-delete.d.ts

@@ -1,12 +0,0 @@
-export type Platform = 'macos' | 'linux' | 'windows';
-export type Shell = 'zsh' | 'bash' | 'fish' | 'powershell' | 'unknown';
-export interface SafeDeleteInfo {
-    command: string | null;
-    installHint: string | null;
-}
-export declare function detectPlatform(): Platform;
-export declare function detectShell(): Shell;
-export declare function getProfilePath(shell: Shell): string | null;
-export declare function getSafeDeleteInfo(platform: Platform): SafeDeleteInfo;
-export declare function hasSafeDelete(platform: Platform): boolean;
-//# sourceMappingURL=safe-delete.d.ts.map

package/plugins/devflow-accessibility/.claude-plugin/plugin.json

@@ -1,21 +0,0 @@
-{
-  "name": "devflow-accessibility",
-  "description": "Web accessibility patterns - WCAG compliance, ARIA roles, keyboard navigation, focus management",
-  "author": {
-    "name": "Dean0x"
-  },
-  "version": "1.8.3",
-  "homepage": "https://github.com/dean0x/devflow",
-  "repository": "https://github.com/dean0x/devflow",
-  "license": "MIT",
-  "keywords": [
-    "accessibility",
-    "wcag",
-    "aria",
-    "a11y"
-  ],
-  "agents": [],
-  "skills": [
-    "accessibility"
-  ]
-}

package/plugins/devflow-accessibility/skills/accessibility/SKILL.md

@@ -1,229 +0,0 @@
----
-name: accessibility
-description: This skill should be used when the user asks to "add accessibility", "check ARIA", "handle keyboard navigation", "add focus management", or creates UI components, forms, or interactive elements. Provides WCAG 2.1 AA patterns for keyboard navigation, ARIA roles and states, focus management, color contrast, and screen reader support.
-user-invocable: false
-allowed-tools: Read, Grep, Glob
-activation:
-  file-patterns:
-    - "**/*.tsx"
-    - "**/*.jsx"
-    - "**/*.css"
-    - "**/*.scss"
-  exclude:
-    - "node_modules/**"
-    - "**/*.test.*"
-    - "**/*.spec.*"
----
-
-# Accessibility Patterns
-
-Reference for web accessibility (WCAG 2.1 AA compliance), keyboard navigation, screen reader support, and inclusive design.
-
-## Iron Law
-
-> **EVERY INTERACTION MUST BE POSSIBLE WITHOUT A MOUSE**
->
-> If a user cannot complete an action using only keyboard, the feature is broken.
-> Mouse-only interactions exclude users with motor disabilities, power users,
-> and anyone navigating with assistive technology. Tab order, focus management,
-> and keyboard shortcuts are not optional enhancements.
-
-## When This Skill Activates
-
-- Creating interactive UI components
-- Building forms and inputs
-- Working with React/JSX code
-- Discussing focus, ARIA, or screen readers
-- Reviewing color schemes or contrast
-
----
-
-## Keyboard Navigation
-
-### Focus Management
-
-```tsx
-// CORRECT: Focus trap in modal
-function Modal({ isOpen, onClose, children }) {
-  const firstFocusable = useRef<HTMLButtonElement>(null);
-
-  useEffect(() => {
-    if (isOpen) firstFocusable.current?.focus();
-  }, [isOpen]);
-
-  return (
-    <div role="dialog" aria-modal="true" onKeyDown={(e) => {
-      if (e.key === 'Escape') onClose();
-    }}>
-      <button ref={firstFocusable}>First action</button>
-      {children}
-    </div>
-  );
-}
-
-// VIOLATION: No focus management, no escape handler
-function BadModal({ children }) {
-  return <div className="modal">{children}</div>;
-}
-```
-
-### Skip Links
-
-```tsx
-// CORRECT: Skip to main content
-<a href="#main-content" className="sr-only focus:not-sr-only">
-  Skip to main content
-</a>
-<main id="main-content" tabIndex={-1}>...</main>
-```
-
----
-
-## ARIA and Semantic HTML
-
-### Prefer Semantic Elements
-
-```tsx
-// CORRECT: Native semantics
-<button onClick={handleClick}>Submit</button>
-<nav aria-label="Main"><ul>...</ul></nav>
-<article><header>...</header></article>
-
-// VIOLATION: Div with role instead of semantic element
-<div role="button" onClick={handleClick}>Submit</div>
-<div role="navigation">...</div>
-```
-
-### Live Regions
-
-```tsx
-// CORRECT: Announce dynamic changes
-<div aria-live="polite" aria-atomic="true">
-  {message && <p>{message}</p>}
-</div>
-
-// For errors (assertive)
-<div role="alert">{errorMessage}</div>
-```
-
----
-
-## Color and Contrast
-
-| Element | Minimum Ratio | WCAG Level |
-|---------|--------------|------------|
-| Normal text (<18px) | 4.5:1 | AA |
-| Large text (>=18px bold, >=24px) | 3:1 | AA |
-| UI components | 3:1 | AA |
-| Enhanced | 7:1 | AAA |
-
-### Never Color-Only Meaning
-
-```tsx
-// VIOLATION: Only color indicates error
-<input style={{ borderColor: hasError ? 'red' : 'gray' }} />
-
-// CORRECT: Icon + text + color
-<input aria-invalid={hasError} aria-describedby="error-msg" />
-{hasError && <span id="error-msg" role="alert">Required field</span>}
-```
-
----
-
-## Motion and Animation
-
-```tsx
-// CORRECT: Respect user preferences
-const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
-
-<div className={prefersReduced ? 'no-animation' : 'animate-fade'}>
-  Content
-</div>
-
-// CSS approach
-@media (prefers-reduced-motion: reduce) {
-  *, *::before, *::after {
-    animation-duration: 0.01ms !important;
-    transition-duration: 0.01ms !important;
-  }
-}
-```
-
----
-
-## Touch and Pointer
-
-### Minimum Target Size
-
-```css
-/* CORRECT: 44x44px minimum touch target */
-.button {
-  min-width: 44px;
-  min-height: 44px;
-  padding: 12px 16px;
-}
-
-/* VIOLATION: Tiny tap targets */
-.icon-button {
-  width: 20px;
-  height: 20px;
-}
-```
-
----
-
-## Forms and Errors
-
-```tsx
-// CORRECT: Associated labels and error linking
-<div>
-  <label htmlFor="email">Email</label>
-  <input
-    id="email"
-    type="email"
-    aria-invalid={!!error}
-    aria-describedby={error ? 'email-error' : undefined}
-  />
-  {error && <span id="email-error" role="alert">{error}</span>}
-</div>
-
-// VIOLATION: Placeholder as label
-<input placeholder="Enter email" />
-```
-
----
-
-## Extended References
-
-For additional patterns and detection rules:
-- `references/violations.md` - Extended accessibility violations
-- `references/patterns.md` - Extended correct patterns
-- `references/detection.md` - Grep patterns for finding issues
-
----
-
-## Severity Guidelines
-
-| Severity | Criteria |
-|----------|----------|
-| CRITICAL | No keyboard access, missing form labels, zero contrast |
-| HIGH | Missing focus indicators, no skip links, color-only meaning |
-| MEDIUM | Missing ARIA labels, poor focus order, small touch targets |
-| LOW | Missing optional enhancements, could improve announcements |
-
----
-
-## Checklist
-
-- [ ] All interactive elements reachable via Tab
-- [ ] Visible focus indicators on all focusable elements
-- [ ] Escape closes modals/dropdowns
-- [ ] Skip link to main content
-- [ ] All form inputs have associated labels
-- [ ] Errors linked via aria-describedby
-- [ ] Color contrast meets 4.5:1 (text) / 3:1 (UI)
-- [ ] No color-only meaning
-- [ ] prefers-reduced-motion respected
-- [ ] Touch targets minimum 44x44px
-- [ ] aria-live for dynamic content
-- [ ] Semantic HTML preferred over ARIA roles