@smartsoft001-mobilems/claude-plugins 2.85.0 → 2.87.0

package/plugins/flow/.claude-plugin/README.md

@@ -1,91 +0,0 @@
-# Flow Plugin for Claude Code
-
-Development flow skills for Linear-driven development workflow.
-
-## Workflow Skills
-
-| Skill | Description |
-|-------|-------------|
-| `/commit` | Create conventional commit based on Linear task |
-| `/impl` | Implement plans from `plan.md` attachment on Linear issue; orchestration saved as `orchestration.md` attachment |
-| `/plan` | Create implementation plan, save as `plan.md` attachment on Linear issue, add `AI Plan` label |
-| `/push` | Push changes and update Linear status (keeps `plan.md` / `orchestration.md` attachments on the issue) |
-
-## Installation
-
-### 1. Enable plugin in project's `.claude/settings.json`:
-
-```json
-{
-  "enabledPlugins": {
-    "flow@mobilems": true
-  }
-}
-```
-
-### 2. Merge permissions from template
-
-Copy permissions from `settings.template.json` to your project's `.claude/settings.json`.
-
-**Quick merge script:**
-
-```bash
-# From project root
-node -e "
-const template = require('node_modules/@smartsoft001-mobilems/claude-plugins/plugins/flow/.claude-plugin/settings.template.json');
-const settings = require('.claude/settings.json');
-
-settings.permissions = settings.permissions || { allow: [], deny: [], ask: [] };
-settings.permissions.allow = [...new Set([...settings.permissions.allow, ...template.permissions.allow])];
-settings.permissions.ask = [...new Set([...settings.permissions.ask, ...template.permissions.ask])];
-
-require('fs').writeFileSync('.claude/settings.json', JSON.stringify(settings, null, 2));
-console.log('Permissions merged!');
-"
-```
-
-## Required MCP Servers
-
-Configure these in your `.mcp.json`:
-
-- `linear` - Linear API integration (MCP prefix `mcp__linear__`)
-- `playwright` - Browser automation for screenshots
-
-### Linear MCP tool dependencies
-
-`/plan`, `/impl`, and `/push` depend on the following `mcp__linear__*` tools (in addition to the standard comment/issue tools):
-
-- `create_attachment` (base64 upload), `get_attachment`, `delete_attachment` — for persisting `plan.md` / `orchestration.md` on issues (attachments are also returned by `get_issue`)
-- `list_issue_labels` — to find the workspace-level `AI Plan` label (the label is pre-configured organization-wide; `/plan` does not create it)
-
-Run `/mcp` after authenticating the Linear MCP server to see the exact loaded tool names. If a tool is exposed under a different name in your deployment, update `settings.template.json` and the `allowed-tools` lists in the three skills accordingly.
-
-## Permission Strategy
-
-### Automatic (allow)
-- Git read operations (status, diff, log, show)
-- Nx commands (test, lint, build)
-- Linear API (read/write issues, comments)
-- Playwright (screenshots)
-- Utility skills
-
-### Requires Confirmation (ask)
-- Workflow skills (/commit, /impl, /plan, /push)
-- `git commit` - creating commits
-- `git push` - pushing to remote
-- `gh pr create` - creating pull requests
-
-## Utility Skills
-
-| Skill | Description |
-|-------|-------------|
-| `maia-files-upload` | Upload files to Maia API |
-| `maia-files-delete` | Delete files from Maia API |
-| `browser-capture` | Capture screenshots with Playwright |
-| `linear-suggestion` | Create Linear issues for improvements |
-| `test-unit` | Run unit tests with coverage |
-| `a11y-audit` | Accessibility audit |
-
-## Agents
-
-See `agents/` directory for full list of specialized agents used by flow skills.

package/plugins/flow/.claude-plugin/merge-permissions.js

@@ -1,97 +0,0 @@
-#!/usr/bin/env node
-/**
- * Merge flow plugin permissions into project's .claude/settings.json
- *
- * Usage:
- *   npx @smartsoft001-mobilems/claude-plugins flow:merge-permissions
- *
- * Or directly:
- *   node node_modules/@smartsoft001-mobilems/claude-plugins/plugins/flow/.claude-plugin/merge-permissions.js
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const SETTINGS_PATH = path.join(process.cwd(), '.claude', 'settings.json');
-const TEMPLATE_PATH = path.join(__dirname, 'settings.template.json');
-
-function loadJson(filePath) {
-  try {
-    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-  } catch (e) {
-    return null;
-  }
-}
-
-function mergeArrays(existing, template) {
-  return [...new Set([...existing, ...template])];
-}
-
-function main() {
-  console.log('Flow Plugin - Merge Permissions\n');
-
-  // Load template
-  const template = loadJson(TEMPLATE_PATH);
-  if (!template) {
-    console.error('ERROR: Could not load template from:', TEMPLATE_PATH);
-    process.exit(1);
-  }
-
-  // Load or create settings
-  let settings = loadJson(SETTINGS_PATH);
-  if (!settings) {
-    console.log('Creating new .claude/settings.json...');
-    fs.mkdirSync(path.dirname(SETTINGS_PATH), { recursive: true });
-    settings = { permissions: { allow: [], deny: [], ask: [] } };
-  }
-
-  // Ensure permissions structure exists
-  settings.permissions = settings.permissions || { allow: [], deny: [], ask: [] };
-  settings.permissions.allow = settings.permissions.allow || [];
-  settings.permissions.ask = settings.permissions.ask || [];
-  settings.permissions.deny = settings.permissions.deny || [];
-
-  // Count before
-  const beforeAllow = settings.permissions.allow.length;
-  const beforeAsk = settings.permissions.ask.length;
-
-  // Merge permissions
-  settings.permissions.allow = mergeArrays(settings.permissions.allow, template.permissions.allow);
-  settings.permissions.ask = mergeArrays(settings.permissions.ask, template.permissions.ask);
-
-  // Enable plugin
-  settings.enabledPlugins = settings.enabledPlugins || {};
-  settings.enabledPlugins['flow@mobilems'] = true;
-
-  // Merge env (shallow merge — template values don't overwrite existing project values)
-  if (template.env) {
-    settings.env = settings.env || {};
-    let addedEnv = 0;
-    for (const [key, value] of Object.entries(template.env)) {
-      if (!(key in settings.env)) {
-        settings.env[key] = value;
-        addedEnv++;
-      }
-    }
-  }
-
-  // Write back
-  fs.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n');
-
-  // Report
-  const addedAllow = settings.permissions.allow.length - beforeAllow;
-  const addedAsk = settings.permissions.ask.length - beforeAsk;
-  const envKeys = template.env ? Object.keys(template.env).filter(k => !k.startsWith('_')) : [];
-  const existingEnvKeys = settings.env ? Object.keys(settings.env) : [];
-
-  console.log('Permissions merged successfully!\n');
-  console.log(`  allow: ${beforeAllow} -> ${settings.permissions.allow.length} (+${addedAllow})`);
-  console.log(`  ask:   ${beforeAsk} -> ${settings.permissions.ask.length} (+${addedAsk})`);
-  if (envKeys.length > 0) {
-    console.log(`  env:   ${envKeys.length} key(s) from template (existing values preserved)`);
-  }
-  console.log(`\nPlugin enabled: flow@mobilems`);
-  console.log(`\nFile updated: ${SETTINGS_PATH}`);
-}
-
-main();

package/plugins/flow/.claude-plugin/plugin.json

@@ -1,5 +0,0 @@
-{
-  "name": "flow",
-  "description": "Development flow skills for Linear-driven development workflow",
-  "version": "2.85.0"
-}

package/plugins/flow/.claude-plugin/settings.template.json

@@ -1,86 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/settings.schema.json",
-  "_description": "Template permissions for flow@mobilems plugin. Merge these into your project's .claude/settings.json",
-  "permissions": {
-    "allow": [
-      "Bash(git status:*)",
-      "Bash(git diff:*)",
-      "Bash(git log:*)",
-      "Bash(git show:*)",
-      "Bash(git add:*)",
-      "Bash(git fetch:*)",
-      "Bash(git pull:*)",
-      "Bash(gh run list:*)",
-      "Bash(gh run view:*)",
-      "Bash(gh pr list:*)",
-      "Bash(nx:*)",
-      "Bash(npx nx:*)",
-      "Bash(npx tsc:*)",
-      "Bash(npm start)",
-      "Bash(npm run format:*)",
-      "Bash(npm audit:*)",
-      "Bash(npm install:*)",
-      "Bash(source:*)",
-      "Bash(nvm use:*)",
-      "Bash(curl:*)",
-      "Bash(lsof:*)",
-      "Bash(ls:*)",
-      "Bash(find:*)",
-      "Bash(grep:*)",
-      "Bash(xargs:*)",
-      "Bash(sleep:*)",
-      "Bash(rm:*)",
-      "Bash(test:*)",
-      "Bash(for:*)",
-      "Bash(node:*)",
-      "Bash(mkdir:*)",
-      "mcp__linear__get_issue",
-      "mcp__linear__list_issues",
-      "mcp__linear__list_comments",
-      "mcp__linear__save_comment",
-      "mcp__linear__delete_comment",
-      "mcp__linear__save_issue",
-      "mcp__linear__list_issue_statuses",
-      "mcp__linear__create_attachment",
-      "mcp__linear__get_attachment",
-      "mcp__linear__delete_attachment",
-      "mcp__linear__list_issue_labels",
-      "mcp__playwright__browser_snapshot",
-      "mcp__playwright__browser_take_screenshot",
-      "mcp__playwright__browser_navigate",
-      "mcp__playwright__browser_close",
-      "mcp__playwright__browser_wait_for",
-      "mcp__playwright__browser_click",
-      "mcp__playwright__browser_resize",
-      "mcp__playwright__browser_evaluate",
-      "mcp__playwright__browser_console_messages",
-      "mcp__playwright__browser_press_key",
-      "mcp__playwright__browser_network_requests",
-      "Skill(flow:maia-files-upload)",
-      "Skill(flow:maia-files-delete)",
-      "Skill(flow:browser-capture)",
-      "Skill(flow:linear-suggestion)",
-      "Skill(flow:test-unit)",
-      "Skill(flow:a11y-audit)",
-      "Skill(flow:test-e2e)",
-      "Skill(flow:review)",
-      "Bash(npx playwright:*)"
-    ],
-    "ask": [
-      "Skill(flow:commit)",
-      "Skill(flow:impl)",
-      "Skill(flow:plan)",
-      "Skill(flow:push)",
-      "Skill(flow:review)",
-      "Bash(git commit:*)",
-      "Bash(git push:*)",
-      "Bash(gh pr create:*)"
-    ]
-  },
-  "enabledPlugins": {
-    "flow@mobilems": true
-  },
-  "env": {
-    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
-  }
-}

package/plugins/flow/agents/angular-component-scaffolder.md

@@ -1,175 +0,0 @@
----
-name: angular-component-scaffolder
-description: Create Angular standalone components with signals and modern patterns. Use when scaffolding new components following Angular 20+ best practices.
-tools: Read, Write, Glob, Grep
-model: sonnet
-color: "#DD0031"
----
-
-You are an expert at creating Angular standalone components following modern best practices.
-
-## Primary Responsibility
-
-Create Angular components using Angular 20+ patterns including signals, standalone architecture, and modern control flow.
-
-## When to Use
-
-- Creating new Angular components
-- Scaffolding component structure with template and styles
-- Setting up component with proper DI using inject()
-
-## Project-Specific Patterns
-
-This project uses:
-
-- **No explicit `standalone: true`** - Angular 19+ defaults to standalone
-- **TranslatePipe** from `@ngx-translate/core` for i18n
-- **CapitalizePipe** from project pipes
-- **Tailwind CSS** with `smart-` prefix
-
-## Component Template
-
-### Basic Component
-
-```typescript
-import { Component, signal, computed, inject } from '@angular/core';
-import { TranslatePipe } from '@ngx-translate/core';
-
-import { CapitalizePipe } from '../../pipes';
-
-@Component({
-  selector: 'app-feature-name',
-  imports: [TranslatePipe, CapitalizePipe],
-  templateUrl: './feature-name.component.html',
-})
-export class FeatureNameComponent {
-  // Injected services (at top)
-  private readonly dataService = inject(DataService);
-
-  // Signals for local state
-  readonly isLoading = signal(false);
-  readonly data = signal<DataType[]>([]);
-
-  // Computed values for derived state
-  readonly itemCount = computed(() => this.data().length);
-  readonly hasData = computed(() => this.data().length > 0);
-}
-```
-
-### Component with Inputs/Outputs
-
-```typescript
-import { Component, input, output, model, signal } from '@angular/core';
-import { TranslatePipe } from '@ngx-translate/core';
-
-import { CapitalizePipe } from '../../pipes';
-
-@Component({
-  selector: 'app-item-card',
-  imports: [TranslatePipe, CapitalizePipe],
-  templateUrl: './item-card.component.html',
-})
-export class ItemCardComponent {
-  // Required inputs
-  label = input.required<string>();
-  item = input.required<Item>();
-
-  // Optional input with default
-  showActions = input<boolean>(true);
-
-  // Input with transform
-  page = input<number, number>(1, {
-    transform: (val: number) => (val < 1 ? 1 : val),
-  });
-
-  // Output events
-  selected = output<Item>();
-  closed = output();
-
-  // Two-way binding (model)
-  searchText = model<string>('');
-
-  // Internal signals
-  isOpen = signal(false);
-
-  // Methods
-  toggleDropdown(force?: boolean) {
-    this.isOpen.update((val) => force ?? !val);
-  }
-}
-```
-
-## Template Patterns
-
-### Modern Control Flow
-
-```html
-@if (isLoading()) {
-<app-spinner />
-} @else if (error()) {
-<app-error [message]="error()?.message" />
-} @else {
-<div class="smart-grid smart-gap-4">
-  @for (item of items(); track item.id) {
-  <app-item-card [item]="item" (selected)="onSelect($event)" />
-  } @empty {
-  <p class="smart-text-gray-500">
-    {{ 'COMMON.noItems' | translate | capitalize }}
-  </p>
-  }
-</div>
-}
-```
-
-## File Structure
-
-```
-feature-name/
-  feature-name.component.ts      # Component class
-  feature-name.component.html    # Template
-  feature-name.component.scss    # Styles (optional)
-```
-
-## Scaffolding Checklist
-
-- [ ] NO `standalone: true` (Angular 19+ default)
-- [ ] Uses `inject()` for DI at top of class
-- [ ] Uses `signal()` for internal state
-- [ ] Uses `computed()` for derived values
-- [ ] Uses `input()`/`input.required()` for inputs
-- [ ] Uses `output()` for outputs
-- [ ] Uses `model()` for two-way binding
-- [ ] Uses `@if`/`@for` in template
-- [ ] Has `track` in all `@for` loops
-- [ ] Imports `TranslatePipe` if using translations
-- [ ] Imports `CapitalizePipe` if capitalizing text
-- [ ] Tailwind classes with `smart-` prefix
-
-## Output Format
-
-```markdown
-## Component Scaffolded
-
-### Files Created
-
-| File                          | Purpose         |
-| ----------------------------- | --------------- |
-| `feature-name.component.ts`   | Component class |
-| `feature-name.component.html` | Template        |
-
-### Component API
-
-**Inputs:**
-
-- `item: Item` (required)
-- `showActions: boolean` (default: true)
-
-**Outputs:**
-
-- `selected: Item`
-
-### Next Steps
-
-1. Implement component logic
-2. Add to routing or parent component
-```

package/plugins/flow/agents/angular-directive-builder.md

@@ -1,153 +0,0 @@
----
-name: angular-directive-builder
-description: Create Angular standalone directives. Use when building attribute or structural directives.
-tools: Read, Write, Glob, Grep
-model: sonnet
-color: "#DD0031"
----
-
-You are an expert at creating Angular directives following modern best practices.
-
-## Primary Responsibility
-
-Create Angular directives using modern patterns including `input()`, `inject()`, and standalone architecture.
-
-## When to Use
-
-- Creating attribute directives
-- Building structural directives
-- Adding behavior to existing elements
-
-## Project-Specific Patterns
-
-This project uses:
-
-- **`standalone: true`** explicitly for directives (for clarity)
-- **`inject()`** for dependency injection
-- **`input()`** for directive inputs
-- **`@HostListener`** for event handling
-- **`ElementRef`** via inject for DOM access
-
-## Directive Template
-
-### Attribute Directive
-
-```typescript
-import {
-  Directive,
-  ElementRef,
-  HostListener,
-  inject,
-  input,
-} from '@angular/core';
-import { TranslateService } from '@ngx-translate/core';
-
-import { ConfirmationModalService } from '../services/confirmation-modal.service';
-
-/**
- * Directive that shows a confirmation modal when clicking external links.
- * Usage: <a href="https://external.com" appExternalLink>Link</a>
- */
-@Directive({
-  selector: 'a[appExternalLink]',
-  standalone: true,
-})
-export class ExternalLinkDirective {
-  private readonly translate = inject(TranslateService);
-  private readonly modalService = inject(ConfirmationModalService);
-  private readonly elementRef = inject(ElementRef);
-
-  /**
-   * Skip confirmation dialog if set to true
-   */
-  skipConfirmation = input<boolean>(false);
-
-  @HostListener('click', ['$event'])
-  async onClick(event: MouseEvent): Promise<void> {
-    if (this.skipConfirmation()) {
-      return;
-    }
-
-    event.preventDefault();
-    event.stopPropagation();
-
-    const message = this.translate.instant('COMMON.externalLinkWarning');
-    const confirmed = await this.modalService.open({ message });
-
-    if (confirmed) {
-      const href = this.elementRef.nativeElement.getAttribute('href');
-      window.open(href, '_blank', 'noopener,noreferrer');
-    }
-  }
-}
-```
-
-### Highlight Directive
-
-```typescript
-import {
-  Directive,
-  ElementRef,
-  HostListener,
-  inject,
-  input,
-} from '@angular/core';
-
-@Directive({
-  selector: '[appHighlight]',
-  standalone: true,
-})
-export class HighlightDirective {
-  private readonly el = inject(ElementRef);
-
-  highlightColor = input<string>('yellow');
-
-  @HostListener('mouseenter')
-  onMouseEnter(): void {
-    this.highlight(this.highlightColor());
-  }
-
-  @HostListener('mouseleave')
-  onMouseLeave(): void {
-    this.highlight('');
-  }
-
-  private highlight(color: string): void {
-    this.el.nativeElement.style.backgroundColor = color;
-  }
-}
-```
-
-## Checklist
-
-- [ ] `standalone: true` set explicitly
-- [ ] Uses `inject()` for DI
-- [ ] Uses `input()` for directive inputs
-- [ ] Uses `@HostListener` for events
-- [ ] Has JSDoc comment explaining usage
-- [ ] Selector follows `[appDirectiveName]` pattern
-
-## Output Format
-
-````markdown
-## Directive Created
-
-### File
-
-`external-link.directive.ts`
-
-### Usage
-
-```html
-<a href="https://example.com" appExternalLink>Link</a>
-<a href="https://example.com" appExternalLink [skipConfirmation]="true">Skip</a>
-```
-````
-
-### Inputs
-
-- `skipConfirmation: boolean` (default: false)
-
-```
-
-```