@smartsoft001-mobilems/claude-plugins 2.63.0 → 2.64.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartsoft001-mobilems/claude-plugins",
-  "version": "2.63.0",
+  "version": "2.64.0",
   "publishConfig": {
     "access": "public"
   },

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

@@ -0,0 +1,82 @@
+# Flow Plugin for Claude Code
+
+Development flow commands for Linear-driven development workflow.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/commit` | Create conventional commit based on Linear task |
+| `/impl` | Implement plans from Linear task comments |
+| `/plan` | Create implementation plan and save to Linear |
+| `/push` | Push changes and update Linear status |
+
+## 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-server` - Linear API integration
+- `playwright` - Browser automation for screenshots
+
+## Permission Strategy
+
+### Automatic (allow)
+- Git read operations (status, diff, log, show)
+- Nx commands (test, lint, build)
+- Linear API (read/write issues, comments)
+- Playwright (screenshots)
+- Internal skills
+
+### Requires Confirmation (ask)
+- Flow commands (/commit, /impl, /plan, /push)
+- `git commit` - creating commits
+- `git push` - pushing to remote
+- `gh pr create` - creating pull requests
+
+## 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 commands.

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

@@ -0,0 +1,80 @@
+#!/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;
+
+  // 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;
+
+  console.log('Permissions merged successfully!\n');
+  console.log(`  allow: ${beforeAllow} -> ${settings.permissions.allow.length} (+${addedAllow})`);
+  console.log(`  ask:   ${beforeAsk} -> ${settings.permissions.ask.length} (+${addedAsk})`);
+  console.log(`\nPlugin enabled: flow@mobilems`);
+  console.log(`\nFile updated: ${SETTINGS_PATH}`);
+}
+
+main();

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

@@ -1,5 +1,24 @@
 {
   "name": "flow",
-  "description": "Development flow",
-  "version": "2.63.0"
+  "description": "Development flow commands for Linear-driven development workflow",
+  "version": "2.64.0",
+  "settingsTemplate": "settings.template.json",
+  "commands": [
+    "commit",
+    "impl",
+    "plan",
+    "push"
+  ],
+  "skills": [
+    "maia-files-upload",
+    "maia-files-delete",
+    "browser-capture",
+    "linear-suggestion",
+    "test-unit",
+    "a11y-audit"
+  ],
+  "requiredMcp": [
+    "linear-server",
+    "playwright"
+  ]
 }

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

@@ -0,0 +1,75 @@
+{
+  "$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-server__get_issue",
+      "mcp__linear-server__list_issues",
+      "mcp__linear-server__list_comments",
+      "mcp__linear-server__create_comment",
+      "mcp__linear-server__update_issue",
+      "mcp__linear-server__list_issue_statuses",
+      "mcp__linear-server__create_issue",
+      "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)"
+    ],
+    "ask": [
+      "Skill(flow:commit)",
+      "Skill(flow:impl)",
+      "Skill(flow:plan)",
+      "Skill(flow:push)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(gh pr create:*)"
+    ]
+  },
+  "enabledPlugins": {
+    "flow@mobilems": true
+  }
+}