specweave 1.0.239 → 1.0.241

package/plugins/specweave-infrastructure/skills/observability/SKILL.md

@@ -25,6 +25,12 @@ Design and implement comprehensive observability systems covering metrics, logs,
 - Prevent alert fatigue
 - Debug microservices latency
 
+## Scope Boundaries
+
+This skill covers **OBSERVABILITY STRATEGY**: SLIs/SLOs, error budgets, dashboards, alerting design.
+
+- For OpenTelemetry instrumentation details → use `/sw-infra:opentelemetry`
+
 ## Core Concepts
 
 ### Three Pillars of Observability

package/plugins/specweave-infrastructure/skills/opentelemetry/SKILL.md

@@ -23,6 +23,12 @@ Design and implement comprehensive observability using OpenTelemetry (OTel). Pro
 - Kubernetes observability setup
 - Cost optimization for telemetry data
 
+## Scope Boundaries
+
+This skill covers **OTEL IMPLEMENTATION**: Collector configuration, auto-instrumentation, sampling strategies.
+
+- For high-level observability strategy and SLOs → use `/sw-infra:observability`
+
 ## OTel Architecture Overview
 
 ```

package/plugins/specweave-jira/lib/jira-permission-gate.js

@@ -1,5 +1,19 @@
 import { promises as fs } from "node:fs";
 import * as path from "node:path";
+function resolvePresetPermissions(preset) {
+  switch (preset) {
+    case "bidirectional":
+      return { canUpsert: true, canUpdateStatus: true };
+    case "push-only":
+      return { canUpsert: true, canUpdateStatus: true };
+    case "full-control":
+      return { canUpsert: true, canUpdateStatus: true };
+    case "read-only":
+      return { canUpsert: false, canUpdateStatus: false };
+    default:
+      return { canUpsert: false, canUpdateStatus: false };
+  }
+}
 const DEFAULT_SYNC_SETTINGS = {
   canUpsertInternalItems: false,
   canUpdateExternalItems: false,
@@ -126,10 +140,12 @@ async function createJiraPermissionGate(projectRoot = process.cwd()) {
   try {
     const content = await fs.readFile(configPath, "utf-8");
     const config = JSON.parse(content);
+    const preset = config?.sync?.preset;
+    const presetDefaults = resolvePresetPermissions(preset);
     const settings = {
       canUpsertInternalItems: config?.sync?.settings?.canUpsertInternalItems ?? false,
-      canUpdateExternalItems: config?.sync?.settings?.canUpdateExternalItems ?? false,
-      canUpdateStatus: config?.sync?.settings?.canUpdateStatus ?? false
+      canUpdateExternalItems: config?.sync?.settings?.canUpdateExternalItems ?? presetDefaults.canUpsert,
+      canUpdateStatus: config?.sync?.settings?.canUpdateStatus ?? presetDefaults.canUpdateStatus
     };
     return new JiraPermissionGate(settings, configPath);
   } catch {

package/plugins/specweave-jira/lib/jira-permission-gate.ts

@@ -55,6 +55,19 @@ export interface SyncSettings {
   canUpdateStatus: boolean;
 }
 
+/**
+ * Resolve preset permissions for fallback when explicit settings are absent
+ */
+function resolvePresetPermissions(preset?: string): { canUpsert: boolean; canUpdateStatus: boolean } {
+  switch (preset) {
+    case 'bidirectional': return { canUpsert: true, canUpdateStatus: true };
+    case 'push-only': return { canUpsert: true, canUpdateStatus: true };
+    case 'full-control': return { canUpsert: true, canUpdateStatus: true };
+    case 'read-only': return { canUpsert: false, canUpdateStatus: false };
+    default: return { canUpsert: false, canUpdateStatus: false };
+  }
+}
+
 /**
  * Default settings (all disabled for safety)
  */
@@ -219,10 +232,14 @@ export async function createJiraPermissionGate(
     const content = await fs.readFile(configPath, 'utf-8');
     const config = JSON.parse(content);
 
+    // v1.0.240 FIX: Honor preset (e.g., "bidirectional") when explicit settings absent
+    const preset = config?.sync?.preset;
+    const presetDefaults = resolvePresetPermissions(preset);
+
     const settings: SyncSettings = {
       canUpsertInternalItems: config?.sync?.settings?.canUpsertInternalItems ?? false,
-      canUpdateExternalItems: config?.sync?.settings?.canUpdateExternalItems ?? false,
-      canUpdateStatus: config?.sync?.settings?.canUpdateStatus ?? false,
+      canUpdateExternalItems: config?.sync?.settings?.canUpdateExternalItems ?? presetDefaults.canUpsert,
+      canUpdateStatus: config?.sync?.settings?.canUpdateStatus ?? presetDefaults.canUpdateStatus,
     };
 
     return new JiraPermissionGate(settings, configPath);

package/plugins/specweave-mobile/PLUGIN.md

@@ -12,8 +12,7 @@ Comprehensive mobile development plugin covering native iOS (SwiftUI), native An
 
 | Skill | Description |
 |-------|-------------|
-| mobile-architect | Mobile system design and architecture for iOS, Android, and cross-platform |
-| react-native-expert | React Native and Expo expert for environment setup, native modules, and performance |
+| react-native-expert | React Native and Expo architect and expert: architecture, setup, native modules, performance, and debugging |
 | swiftui | iOS native development with SwiftUI, Swift 6, SwiftData, and modern Apple frameworks |
 | jetpack-compose | Android native development with Jetpack Compose, Kotlin, Material Design 3, and Hilt |
 | flutter | Cross-platform development with Flutter and Dart 3+, Riverpod, GoRouter |

package/plugins/specweave-mobile/README.md

@@ -66,15 +66,16 @@ The SpecWeave Mobile plugin provides specialized skills and agents for modern Re
    - Monorepo configuration
    - Hermes bytecode optimization
 
-### Mobile Architect Agent
+### React Native Expert (Architecture + Implementation)
 
-The `mobile-architect` agent specializes in:
+The `react-native-expert` skill covers both architecture and hands-on implementation:
 - Application architecture design for React Native / Expo
 - State management selection (Zustand, TanStack Query, Jotai, Legend State)
 - Navigation with Expo Router and React Navigation
 - Performance architecture with modern React features
 - Platform-specific strategies (iOS design patterns, Android edge-to-edge)
-- Testing architecture
+- Environment setup, Metro bundler, native modules
+- Device testing, debugging, and performance optimization
 - Build and deployment pipelines with EAS
 
 ## Installation
@@ -110,15 +111,15 @@ You: "I need to debug network requests in my app"
 → mobile-debugging skill activates
 ```
 
-### Invoke the Mobile Architect Skill
+### Invoke the React Native Expert Skill
 
-For architectural decisions and system design:
+For architectural decisions, system design, setup, and debugging:
 
 ```
-Use the Skill tool to invoke the mobile-architect skill:
+Use the Skill tool to invoke the react-native-expert skill:
 
 Skill({
-  skill: "sw-mobile:mobile-architect",
+  skill: "sw-mobile:react-native-expert",
   args: "Design a scalable React Native architecture for a social media app with feed, messaging, and profile features. Include state management, navigation, and performance considerations."
 })
 ```
@@ -157,10 +158,10 @@ Skill({
 
 ### 4. Architecture Design
 
-**User invokes**: mobile-architect agent
+**User invokes**: react-native-expert skill
 
 **What happens**:
-- Agent analyzes requirements
+- Skill analyzes requirements
 - Recommends folder structure
 - Selects state management solution
 - Designs navigation architecture
@@ -258,11 +259,11 @@ import { FlashList } from "@shopify/flash-list";
 ### Example 3: Architecture Design
 
 ```
-User invokes: mobile-architect agent
+User invokes: react-native-expert skill
 
 "Design architecture for a social media app with posts, comments, and real-time chat"
 
-Agent response:
+Skill response:
 # Architecture Recommendation: Social Media App
 
 ## Folder Structure (Feature-Based)
@@ -312,7 +313,7 @@ React Navigation with:
 
 - Check the [React Native Setup Guide](.specweave/docs/public/guides/mobile/react-native-setup-guide.md)
 - Review skill documentation in `skills/*/SKILL.md`
-- Invoke the mobile-architect agent for architectural questions
+- Invoke the react-native-expert skill for architectural questions
 
 ## Contributing
 

package/plugins/specweave-mobile/skills/capacitor-ionic/SKILL.md

@@ -9,25 +9,11 @@ context: fork
 
 Comprehensive expertise in **Capacitor 6+** and **Ionic Framework** for building cross-platform mobile applications from web technologies. Covers architecture, native API access, custom plugin development, deployment, and when to choose Capacitor over React Native or Flutter.
 
-## CRITICAL: Fetching Current Documentation
+## Fetching Current Documentation
 
-**Before providing version-specific guidance, ALWAYS fetch the latest documentation:**
+**Before providing version-specific guidance, verify current versions.** Capacitor releases frequently, and plugin APIs evolve. Always verify current APIs before recommending specific patterns.
 
-```typescript
-// Capacitor
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "@capacitor/core",
-  query: "Capacitor latest version features and plugin API"
-});
-
-// Ionic Framework
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "@ionic/angular",
-  query: "Ionic Framework latest version components and features"
-});
-```
-
-**Why?** Capacitor releases frequently, and plugin APIs evolve. Always verify current APIs before recommending specific patterns.
+For library documentation, use WebSearch or install Context7 manually: `claude plugin install context7@claude-plugins-official`
 
 ## Capacitor 6+ Architecture
 
@@ -809,6 +795,6 @@ describe('Product List', () => {
 ## Related Skills
 
 - `expo` - Expo/React Native for comparison
-- `mobile-architect` - Architecture decisions
+- `react-native-expert` - Architecture and RN/Expo expertise
 - `mobile-testing` - Testing Ionic/Capacitor apps
 - `deep-linking-push` - Deep linking and push in Capacitor

package/plugins/specweave-mobile/skills/deep-linking-push/SKILL.md

@@ -9,29 +9,11 @@ context: fork
 
 Comprehensive expertise in **deep linking** (Universal Links, App Links, deferred deep linking) and **push notifications** (APNs, FCM, rich notifications, silent push) across iOS, Android, React Native, and Flutter.
 
-## CRITICAL: Fetching Current Documentation
+## Fetching Current Documentation
 
-**Before providing version-specific guidance, ALWAYS fetch the latest documentation:**
+**Before providing version-specific guidance, verify current versions.** Library APIs for notifications, deep linking, and routing evolve frequently.
 
-```typescript
-// expo-notifications
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "expo-notifications",
-  query: "Expo notifications setup push notification configuration"
-});
-
-// Firebase Messaging (Flutter)
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "firebase_messaging",
-  query: "Firebase Cloud Messaging Flutter setup and configuration"
-});
-
-// Expo Router deep linking
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "expo-router",
-  query: "Deep linking URL handling and navigation"
-});
-```
+For library documentation, use WebSearch or install Context7 manually: `claude plugin install context7@claude-plugins-official`
 
 ---
 
@@ -808,6 +790,6 @@ function trackNotificationTap(notificationId: string, action: string) {
 ## Related Skills
 
 - `expo` - Expo-specific notification and linking setup
-- `mobile-architect` - Navigation architecture for deep link routing
+- `react-native-expert` - Navigation architecture for deep link routing
 - `mobile-testing` - Testing deep links and notifications
 - `capacitor-ionic` - Capacitor deep linking and push setup

package/plugins/specweave-mobile/skills/expo/SKILL.md

@@ -9,31 +9,11 @@ context: fork
 
 Comprehensive expertise in **Expo SDK 52+**, the **managed workflow**, and the **React Native New Architecture** (Fabric, TurboModules, JSI). Covers the full lifecycle from project creation through App Store and Play Store submission using EAS.
 
-## CRITICAL: Fetching Current Documentation
+## Fetching Current Documentation
 
-**Before providing version-specific guidance, ALWAYS fetch the latest documentation:**
+**Before providing version-specific guidance, verify current versions.** Expo SDK releases every ~3 months and React Native every ~8 weeks. Static version numbers go stale quickly.
 
-```typescript
-// Expo SDK - get current version info
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "expo",
-  query: "Expo SDK latest version features and migration guide"
-});
-
-// Expo Router - get current routing docs
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "expo-router",
-  query: "Expo Router file-based routing configuration"
-});
-
-// React Native - New Architecture status
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "react-native",
-  query: "React Native New Architecture Fabric TurboModules"
-});
-```
-
-**Why?** Expo SDK releases every ~3 months and React Native every ~8 weeks. Static version numbers go stale quickly. Always verify current versions before recommending specific APIs.
+For library documentation, use WebSearch or install Context7 manually: `claude plugin install context7@claude-plugins-official`
 
 ## Expo SDK 52+ and the Managed Workflow
 
@@ -655,7 +635,7 @@ eas submit --platform android --latest
 
 ## Related Skills
 
-- `mobile-architect` - Architecture decisions and patterns
+- `react-native-expert` - Architecture decisions and patterns
 - `react-native-expert` - Bare RN setup, Metro, debugging
 - `mobile-testing` - Comprehensive testing strategies
 - `deep-linking-push` - Deep linking and push notification details

package/plugins/specweave-mobile/skills/mobile-testing/SKILL.md

@@ -9,29 +9,11 @@ context: fork
 
 Comprehensive mobile testing expertise across **iOS**, **Android**, **React Native**, and **Flutter**. Covers the full testing pyramid from unit tests through E2E, plus CI/CD integration, device farms, performance testing, and accessibility automation.
 
-## CRITICAL: Fetching Current Documentation
+## Fetching Current Documentation
 
-**Before providing version-specific guidance, ALWAYS fetch the latest documentation:**
+**Before providing version-specific guidance, verify current versions.** Testing frameworks like Detox, Testing Library, and Maestro evolve frequently.
 
-```typescript
-// Detox - React Native E2E testing
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "detox",
-  query: "Detox E2E testing setup and configuration"
-});
-
-// Testing Library - React Native
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "@testing-library/react-native",
-  query: "React Native Testing Library component testing"
-});
-
-// Maestro - Cross-platform E2E
-mcp__plugin_context7_context7__resolve-library-id({
-  libraryName: "maestro",
-  query: "Maestro mobile E2E testing framework"
-});
-```
+For library documentation, use WebSearch or install Context7 manually: `claude plugin install context7@claude-plugins-official`
 
 ## Test Strategy: The Mobile Testing Pyramid
 
@@ -702,5 +684,5 @@ genhtml coverage/lcov.info -o coverage/html
 
 - `expo` - Expo-specific testing setup
 - `react-native-expert` - React Native debugging tools
-- `mobile-architect` - Architecture for testability
+- `react-native-expert` - Architecture for testability
 - `deep-linking-push` - Testing deep links and notifications