@mmerterden/multi-agent-pipeline 20.36.0 → 20.37.0

package/pipeline/skills/shared/external/typescript-patterns/references/code-examples.md

@@ -0,0 +1,100 @@
+# TypeScript Code Examples
+
+Full code samples for the SKILL.md sections that link here. The rules and the decision guidance stay in SKILL.md; each heading below matches the SKILL.md section the code belongs to.
+
+## Discriminated Unions
+
+```typescript
+// API response pattern
+type ApiResult<T> =
+  | { status: 'success'; data: T }
+  | { status: 'error'; error: { code: string; message: string } }
+  | { status: 'loading' };
+
+function handleResult<T>(result: ApiResult<T>): string {
+  switch (result.status) {
+    case 'success':
+      return JSON.stringify(result.data);
+    case 'error':
+      return `Error ${result.error.code}: ${result.error.message}`;
+    case 'loading':
+      return 'Loading...';
+  }
+}
+
+// Event system
+type AppEvent =
+  | { type: 'USER_LOGIN'; payload: { userId: string } }
+  | { type: 'USER_LOGOUT' }
+  | { type: 'ITEM_ADDED'; payload: { itemId: string; quantity: number } }
+  | { type: 'ITEM_REMOVED'; payload: { itemId: string } };
+
+function handleEvent(event: AppEvent): void {
+  switch (event.type) {
+    case 'USER_LOGIN':
+      console.log(`User ${event.payload.userId} logged in`);
+      break;
+    case 'USER_LOGOUT':
+      console.log('User logged out');
+      break;
+    case 'ITEM_ADDED':
+      console.log(`Added ${event.payload.quantity} of ${event.payload.itemId}`);
+      break;
+    case 'ITEM_REMOVED':
+      console.log(`Removed ${event.payload.itemId}`);
+      break;
+  }
+}
+
+// Exhaustive check helper
+function exhaustiveCheck(value: never): never {
+  throw new Error(`Unhandled value: ${JSON.stringify(value)}`);
+}
+```
+
+## Zod for Runtime Validation
+
+```typescript
+import { z } from 'zod';
+
+// Define schema
+const UserSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string().min(1).max(100),
+  email: z.string().email(),
+  role: z.enum(['admin', 'user', 'viewer']),
+  age: z.number().int().min(0).max(150).optional(),
+  tags: z.array(z.string()).default([]),
+});
+
+// Infer TypeScript type from schema
+type User = z.infer<typeof UserSchema>;
+
+// Validate at runtime
+function createUser(input: unknown): User {
+  return UserSchema.parse(input); // throws ZodError on failure
+}
+
+// Safe parse (no throw)
+function validateUser(input: unknown): ApiResult<User> {
+  const result = UserSchema.safeParse(input);
+  if (result.success) {
+    return { status: 'success', data: result.data };
+  }
+  return {
+    status: 'error',
+    error: { code: 'VALIDATION', message: result.error.message },
+  };
+}
+
+// Schema composition
+const CreateUserSchema = UserSchema.omit({ id: true });
+const UpdateUserSchema = UserSchema.partial().required({ id: true });
+
+// API request validation
+const PaginationSchema = z.object({
+  page: z.coerce.number().int().min(1).default(1),
+  limit: z.coerce.number().int().min(1).max(100).default(20),
+  sort: z.enum(['asc', 'desc']).default('desc'),
+});
+```

package/pipeline/skills/shared/external/vision-framework/SKILL.md

@@ -291,26 +291,7 @@ Model loading, compute units, conversion and optimization belong to the
 `DataScannerViewController` (iOS 16+) is a full-screen live camera that finds
 text and barcodes and highlights them.
 
-```swift
-import UIKit
-import VisionKit
-
-@MainActor
-func presentTicketScanner(from host: UIViewController, delegate: DataScannerViewControllerDelegate) {
-    guard DataScannerViewController.isSupported, DataScannerViewController.isAvailable else { return }
-    let scanner = DataScannerViewController(
-        recognizedDataTypes: [.text(languages: ["en"]), .barcode(symbologies: [.qr, .aztec])],
-        qualityLevel: .balanced,
-        recognizesMultipleItems: false,
-        isHighFrameRateTrackingEnabled: true,
-        isHighlightingEnabled: true
-    )
-    scanner.delegate = delegate
-    host.present(scanner, animated: true) {
-        try? scanner.startScanning()
-    }
-}
-```
+Code: [VisionKit live scanning: DataScannerViewController](references/code-examples.md#visionkit-live-scanning-datascannerviewcontroller).
 
 `isSupported` checks the hardware (A12 Bionic or later); `isAvailable`
 additionally requires camera permission. In SwiftUI, wrap the controller in a
@@ -362,3 +343,4 @@ additionally requires camera permission. In SwiftUI, wrap the controller in a
 - https://developer.apple.com/documentation/visionkit
 - https://developer.apple.com/documentation/vision/recognizetextrequest
 - https://developer.apple.com/documentation/visionkit/datascannerviewcontroller
+- [Code examples](references/code-examples.md): open for the full code behind VisionKit live scanning: DataScannerViewController.

package/pipeline/skills/shared/external/vision-framework/references/code-examples.md

@@ -0,0 +1,26 @@
+# Vision Framework Code Examples
+
+Full code samples for the SKILL.md sections that link here. The rules and the decision guidance stay in SKILL.md; each heading below matches the SKILL.md section the code belongs to.
+
+## VisionKit live scanning: DataScannerViewController
+
+```swift
+import UIKit
+import VisionKit
+
+@MainActor
+func presentTicketScanner(from host: UIViewController, delegate: DataScannerViewControllerDelegate) {
+    guard DataScannerViewController.isSupported, DataScannerViewController.isAvailable else { return }
+    let scanner = DataScannerViewController(
+        recognizedDataTypes: [.text(languages: ["en"]), .barcode(symbologies: [.qr, .aztec])],
+        qualityLevel: .balanced,
+        recognizesMultipleItems: false,
+        isHighFrameRateTrackingEnabled: true,
+        isHighlightingEnabled: true
+    )
+    scanner.delegate = delegate
+    host.present(scanner, animated: true) {
+        try? scanner.startScanning()
+    }
+}
+```

package/pipeline/skills/shared/external/vue-composition/SKILL.md

@@ -164,181 +164,15 @@ watch(
 
 ## Composables (useXxx Pattern)
 
-```typescript
-// composables/useFetch.ts
-import { ref, type Ref } from 'vue';
-
-interface UseFetchReturn<T> {
-  data: Ref<T | null>;
-  error: Ref<string | null>;
-  isLoading: Ref<boolean>;
-  execute: () => Promise<void>;
-}
-
-export function useFetch<T>(url: string | Ref<string>): UseFetchReturn<T> {
-  const data = ref<T | null>(null) as Ref<T | null>;
-  const error = ref<string | null>(null);
-  const isLoading = ref(false);
-
-  async function execute() {
-    isLoading.value = true;
-    error.value = null;
-    try {
-      const resolvedUrl = typeof url === 'string' ? url : url.value;
-      const response = await fetch(resolvedUrl);
-      if (!response.ok) throw new Error(`HTTP ${response.status}`);
-      data.value = await response.json();
-    } catch (e) {
-      error.value = e instanceof Error ? e.message : 'Unknown error';
-    } finally {
-      isLoading.value = false;
-    }
-  }
-
-  return { data, error, isLoading, execute };
-}
-
-// composables/useLocalStorage.ts
-import { ref, watch, type Ref } from 'vue';
-
-export function useLocalStorage<T>(key: string, defaultValue: T): Ref<T> {
-  const stored = localStorage.getItem(key);
-  const data = ref<T>(stored ? JSON.parse(stored) : defaultValue) as Ref<T>;
-
-  watch(data, (newValue) => {
-    localStorage.setItem(key, JSON.stringify(newValue));
-  }, { deep: true });
-
-  return data;
-}
-
-// composables/useDebounce.ts
-import { ref, watch, type Ref } from 'vue';
-
-export function useDebounce<T>(source: Ref<T>, delay = 300): Ref<T> {
-  const debounced = ref(source.value) as Ref<T>;
-  let timeout: ReturnType<typeof setTimeout>;
-
-  watch(source, (newValue) => {
-    clearTimeout(timeout);
-    timeout = setTimeout(() => {
-      debounced.value = newValue;
-    }, delay);
-  });
-
-  return debounced;
-}
-```
+Code for this section: [Vue examples](references/vue-examples.md).
 
 ## Pinia State Management
 
-```typescript
-// stores/auth.ts
-import { defineStore } from 'pinia';
-import { ref, computed } from 'vue';
-
-export const useAuthStore = defineStore('auth', () => {
-  // State
-  const user = ref<User | null>(null);
-  const token = ref<string | null>(null);
-
-  // Getters
-  const isAuthenticated = computed(() => !!token.value);
-  const displayName = computed(() => user.value?.name ?? 'Guest');
-
-  // Actions
-  async function login(credentials: { email: string; password: string }) {
-    const response = await api.post('/auth/login', credentials);
-    user.value = response.user;
-    token.value = response.token;
-  }
-
-  function logout() {
-    user.value = null;
-    token.value = null;
-  }
-
-  return { user, token, isAuthenticated, displayName, login, logout };
-}, {
-  persist: true, // pinia-plugin-persistedstate
-});
-
-// stores/cart.ts
-export const useCartStore = defineStore('cart', () => {
-  const items = ref<CartItem[]>([]);
-
-  const totalItems = computed(() =>
-    items.value.reduce((sum, item) => sum + item.quantity, 0)
-  );
-
-  const totalPrice = computed(() =>
-    items.value.reduce((sum, item) => sum + item.price * item.quantity, 0)
-  );
-
-  function addItem(product: Product) {
-    const existing = items.value.find((i) => i.productId === product.id);
-    if (existing) {
-      existing.quantity++;
-    } else {
-      items.value.push({ productId: product.id, name: product.name, price: product.price, quantity: 1 });
-    }
-  }
-
-  function removeItem(productId: string) {
-    items.value = items.value.filter((i) => i.productId !== productId);
-  }
-
-  return { items, totalItems, totalPrice, addItem, removeItem };
-});
-```
+Code for this section: [Vue examples](references/vue-examples.md).
 
 ## Vue Router 4
 
-```typescript
-// router/index.ts
-import { createRouter, createWebHistory } from 'vue-router';
-import type { RouteRecordRaw } from 'vue-router';
-
-const routes: RouteRecordRaw[] = [
-  {
-    path: '/',
-    component: () => import('@/layouts/DefaultLayout.vue'),
-    children: [
-      { path: '', name: 'home', component: () => import('@/pages/HomePage.vue') },
-      { path: 'about', name: 'about', component: () => import('@/pages/AboutPage.vue') },
-    ],
-  },
-  {
-    path: '/dashboard',
-    component: () => import('@/layouts/DashboardLayout.vue'),
-    meta: { requiresAuth: true },
-    children: [
-      { path: '', name: 'dashboard', component: () => import('@/pages/DashboardPage.vue') },
-      { path: 'settings', name: 'settings', component: () => import('@/pages/SettingsPage.vue') },
-      { path: 'users/:id', name: 'user-detail', component: () => import('@/pages/UserDetailPage.vue'), props: true },
-    ],
-  },
-  { path: '/:pathMatch(.*)*', name: 'not-found', component: () => import('@/pages/NotFoundPage.vue') },
-];
-
-const router = createRouter({
-  history: createWebHistory(),
-  routes,
-  scrollBehavior(to, from, savedPosition) {
-    return savedPosition ?? { top: 0 };
-  },
-});
-
-// Navigation guard
-router.beforeEach((to, from) => {
-  const auth = useAuthStore();
-  if (to.meta.requiresAuth && !auth.isAuthenticated) {
-    return { name: 'login', query: { redirect: to.fullPath } };
-  }
-});
-
-export default router;
-```
+Code for this section: [Vue examples](references/vue-examples.md).
 
 ## Do's
 
@@ -372,3 +206,7 @@ export default router;
 | Prop mutation warning | Modifying prop directly | Use `defineModel` or emit event with new value |
 | Template ref is null | Accessed before mount | Use `onMounted` hook or optional chaining |
 | Pinia state lost on refresh | No persistence plugin | Add `pinia-plugin-persistedstate` |
+
+## References
+
+- [Vue examples](references/vue-examples.md): open when writing a composable, a Pinia store or router configuration and guards.

package/pipeline/skills/shared/external/vue-composition/references/vue-examples.md

@@ -0,0 +1,187 @@
+# Vue examples
+
+<!-- toc -->
+- [Composables (useXxx Pattern)](#composables-usexxx-pattern)
+- [Pinia State Management](#pinia-state-management)
+- [Vue Router 4](#vue-router-4)
+<!-- /toc -->
+
+Code for composables, Pinia stores and Vue Router 4. SKILL.md keeps the core concepts, script setup, reactivity and watcher rules.
+
+## Composables (useXxx Pattern)
+
+```typescript
+// composables/useFetch.ts
+import { ref, type Ref } from 'vue';
+
+interface UseFetchReturn<T> {
+  data: Ref<T | null>;
+  error: Ref<string | null>;
+  isLoading: Ref<boolean>;
+  execute: () => Promise<void>;
+}
+
+export function useFetch<T>(url: string | Ref<string>): UseFetchReturn<T> {
+  const data = ref<T | null>(null) as Ref<T | null>;
+  const error = ref<string | null>(null);
+  const isLoading = ref(false);
+
+  async function execute() {
+    isLoading.value = true;
+    error.value = null;
+    try {
+      const resolvedUrl = typeof url === 'string' ? url : url.value;
+      const response = await fetch(resolvedUrl);
+      if (!response.ok) throw new Error(`HTTP ${response.status}`);
+      data.value = await response.json();
+    } catch (e) {
+      error.value = e instanceof Error ? e.message : 'Unknown error';
+    } finally {
+      isLoading.value = false;
+    }
+  }
+
+  return { data, error, isLoading, execute };
+}
+
+// composables/useLocalStorage.ts
+import { ref, watch, type Ref } from 'vue';
+
+export function useLocalStorage<T>(key: string, defaultValue: T): Ref<T> {
+  const stored = localStorage.getItem(key);
+  const data = ref<T>(stored ? JSON.parse(stored) : defaultValue) as Ref<T>;
+
+  watch(data, (newValue) => {
+    localStorage.setItem(key, JSON.stringify(newValue));
+  }, { deep: true });
+
+  return data;
+}
+
+// composables/useDebounce.ts
+import { ref, watch, type Ref } from 'vue';
+
+export function useDebounce<T>(source: Ref<T>, delay = 300): Ref<T> {
+  const debounced = ref(source.value) as Ref<T>;
+  let timeout: ReturnType<typeof setTimeout>;
+
+  watch(source, (newValue) => {
+    clearTimeout(timeout);
+    timeout = setTimeout(() => {
+      debounced.value = newValue;
+    }, delay);
+  });
+
+  return debounced;
+}
+```
+
+## Pinia State Management
+
+```typescript
+// stores/auth.ts
+import { defineStore } from 'pinia';
+import { ref, computed } from 'vue';
+
+export const useAuthStore = defineStore('auth', () => {
+  // State
+  const user = ref<User | null>(null);
+  const token = ref<string | null>(null);
+
+  // Getters
+  const isAuthenticated = computed(() => !!token.value);
+  const displayName = computed(() => user.value?.name ?? 'Guest');
+
+  // Actions
+  async function login(credentials: { email: string; password: string }) {
+    const response = await api.post('/auth/login', credentials);
+    user.value = response.user;
+    token.value = response.token;
+  }
+
+  function logout() {
+    user.value = null;
+    token.value = null;
+  }
+
+  return { user, token, isAuthenticated, displayName, login, logout };
+}, {
+  persist: true, // pinia-plugin-persistedstate
+});
+
+// stores/cart.ts
+export const useCartStore = defineStore('cart', () => {
+  const items = ref<CartItem[]>([]);
+
+  const totalItems = computed(() =>
+    items.value.reduce((sum, item) => sum + item.quantity, 0)
+  );
+
+  const totalPrice = computed(() =>
+    items.value.reduce((sum, item) => sum + item.price * item.quantity, 0)
+  );
+
+  function addItem(product: Product) {
+    const existing = items.value.find((i) => i.productId === product.id);
+    if (existing) {
+      existing.quantity++;
+    } else {
+      items.value.push({ productId: product.id, name: product.name, price: product.price, quantity: 1 });
+    }
+  }
+
+  function removeItem(productId: string) {
+    items.value = items.value.filter((i) => i.productId !== productId);
+  }
+
+  return { items, totalItems, totalPrice, addItem, removeItem };
+});
+```
+
+## Vue Router 4
+
+```typescript
+// router/index.ts
+import { createRouter, createWebHistory } from 'vue-router';
+import type { RouteRecordRaw } from 'vue-router';
+
+const routes: RouteRecordRaw[] = [
+  {
+    path: '/',
+    component: () => import('@/layouts/DefaultLayout.vue'),
+    children: [
+      { path: '', name: 'home', component: () => import('@/pages/HomePage.vue') },
+      { path: 'about', name: 'about', component: () => import('@/pages/AboutPage.vue') },
+    ],
+  },
+  {
+    path: '/dashboard',
+    component: () => import('@/layouts/DashboardLayout.vue'),
+    meta: { requiresAuth: true },
+    children: [
+      { path: '', name: 'dashboard', component: () => import('@/pages/DashboardPage.vue') },
+      { path: 'settings', name: 'settings', component: () => import('@/pages/SettingsPage.vue') },
+      { path: 'users/:id', name: 'user-detail', component: () => import('@/pages/UserDetailPage.vue'), props: true },
+    ],
+  },
+  { path: '/:pathMatch(.*)*', name: 'not-found', component: () => import('@/pages/NotFoundPage.vue') },
+];
+
+const router = createRouter({
+  history: createWebHistory(),
+  routes,
+  scrollBehavior(to, from, savedPosition) {
+    return savedPosition ?? { top: 0 };
+  },
+});
+
+// Navigation guard
+router.beforeEach((to, from) => {
+  const auth = useAuthStore();
+  if (to.meta.requiresAuth && !auth.isAuthenticated) {
+    return { name: 'login', query: { redirect: to.fullPath } };
+  }
+});
+
+export default router;
+```