@smartsoft001-mobilems/claude-plugins 2.67.0 → 2.69.0

package/plugins/flow-legacy/skills/debug-helper/SKILL.md

@@ -0,0 +1,387 @@
+---
+name: debug-helper
+description: Cross-stack debugging workflows for Angular 14, NestJS, and MongoDB applications
+---
+
+# Debug Helper (Angular 14 Legacy)
+
+This skill provides debugging workflows and techniques for Angular 14 legacy projects.
+
+## 1. Angular 14 Debugging
+
+### Component Not Rendering
+
+1. **Check selector usage**
+
+   ```typescript
+   // Verify selector matches
+   @Component({ selector: 'app-my-component' })
+   // Template: <app-my-component></app-my-component>
+   ```
+
+2. **Check module declarations**
+
+   ```typescript
+   @NgModule({
+     declarations: [MyComponent], // Is it declared?
+     exports: [MyComponent],      // Is it exported (if used outside)?
+   })
+   export class FeatureModule {}
+   ```
+
+3. **Check module imports**
+   ```typescript
+   @NgModule({
+     imports: [FeatureModule], // Is feature module imported?
+   })
+   export class AppModule {}
+   ```
+
+### BehaviorSubject/Observable Issues
+
+1. **BehaviorSubject not updating view**
+
+   ```typescript
+   // Wrong: mutating array directly
+   const items = this._items.getValue();
+   items.push(newItem); // Won't trigger update
+   this._items.next(items);
+
+   // Correct: create new reference
+   const items = this._items.getValue();
+   this._items.next([...items, newItem]);
+   ```
+
+2. **Subscription not receiving values**
+
+   ```typescript
+   // Ensure subscription is active
+   ngOnInit(): void {
+     this.items$ = this.stateService.items$;
+
+     // Debug: log values
+     this.items$.pipe(
+       tap(items => console.log('Items received:', items)),
+       takeUntil(this.destroy$)
+     ).subscribe();
+   }
+   ```
+
+3. **Memory leak from subscriptions**
+   ```typescript
+   // Always unsubscribe with takeUntil pattern
+   private readonly destroy$ = new Subject<void>();
+
+   ngOnInit(): void {
+     this.service.data$
+       .pipe(takeUntil(this.destroy$))
+       .subscribe(data => this.data = data);
+   }
+
+   ngOnDestroy(): void {
+     this.destroy$.next();
+     this.destroy$.complete();
+   }
+   ```
+
+### Change Detection Issues
+
+```typescript
+// Force change detection (use sparingly)
+constructor(private cdr: ChangeDetectorRef) {}
+
+// After async operation
+this.cdr.detectChanges();
+
+// Or mark for check (OnPush)
+this.cdr.markForCheck();
+```
+
+### HTTP Debugging (Angular 14)
+
+```typescript
+// HTTP interceptor for logging
+@Injectable()
+export class LoggingInterceptor implements HttpInterceptor {
+  intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {
+    console.log('Request:', req.method, req.url);
+
+    return next.handle(req).pipe(
+      tap({
+        next: (event) => {
+          if (event instanceof HttpResponse) {
+            console.log('Response:', event.status, event.body);
+          }
+        },
+        error: (error) => console.error('HTTP Error:', error),
+      })
+    );
+  }
+}
+
+// Register in module
+@NgModule({
+  providers: [
+    { provide: HTTP_INTERCEPTORS, useClass: LoggingInterceptor, multi: true },
+  ],
+})
+export class AppModule {}
+```
+
+### Template Debugging
+
+```html
+<!-- Debug in template with json pipe -->
+<pre>{{ data | json }}</pre>
+
+<!-- Debug *ngIf condition -->
+<p>isLoading: {{ isLoading }}</p>
+<p>items.length: {{ items?.length }}</p>
+
+<!-- Debug *ngFor -->
+<div *ngFor="let item of items; let i = index">
+  {{ i }}: {{ item | json }}
+</div>
+```
+
+### Browser DevTools
+
+1. **Angular DevTools** - Install Chrome extension (works with Angular 14)
+2. **Component inspector** - Click "Components" tab
+3. **Profiler** - Record change detection cycles
+4. **Network tab** - Check API calls
+
+## 2. NestJS Debugging
+
+### Request Not Reaching Controller
+
+1. **Check route path**
+
+   ```typescript
+   @Controller('features')  // /features
+   @Get(':id')              // /features/:id
+   ```
+
+2. **Check module imports**
+
+   ```typescript
+   @Module({
+     imports: [FeatureModule], // Is module imported?
+   })
+   export class AppModule {}
+   ```
+
+3. **Check guards/interceptors**
+   ```typescript
+   @UseGuards(AuthGuard)  // Is guard blocking?
+   ```
+
+### Dependency Injection Errors
+
+```
+Error: Nest can't resolve dependencies of FeatureService
+```
+
+**Solutions:**
+
+1. Check provider is in module
+
+   ```typescript
+   @Module({
+     providers: [FeatureService, FeatureRepository],
+   })
+   ```
+
+2. Check circular dependencies
+
+   ```typescript
+   // Use forwardRef
+   @Inject(forwardRef(() => OtherService))
+   private readonly other: OtherService,
+   ```
+
+3. Check module exports
+   ```typescript
+   @Module({
+     providers: [SharedService],
+     exports: [SharedService], // Must export if used elsewhere
+   })
+   ```
+
+### Logging
+
+```typescript
+import { Logger } from '@nestjs/common';
+
+@Injectable()
+export class FeatureService {
+  private readonly logger = new Logger(FeatureService.name);
+
+  async findAll() {
+    this.logger.log('Finding all features');
+    this.logger.debug('Debug info');
+    this.logger.warn('Warning');
+    this.logger.error('Error occurred', error.stack);
+  }
+}
+```
+
+## 3. MongoDB/Mongoose Debugging
+
+### Connection Issues
+
+```typescript
+// Log connection events
+mongoose.connection.on('connected', () => console.log('MongoDB connected'));
+mongoose.connection.on('error', (err) => console.error('MongoDB error:', err));
+mongoose.connection.on('disconnected', () => console.log('MongoDB disconnected'));
+```
+
+### Query Debugging
+
+```typescript
+// Enable Mongoose debug mode
+mongoose.set('debug', true);
+
+// Or for specific query
+const result = await this.model.find({ status: 'active' });
+console.log('Query:', this.model.find({ status: 'active' }).getQuery());
+```
+
+## 4. Common Debugging Patterns
+
+### Console Debugging
+
+```typescript
+// Temporary debug logs (remove before commit)
+console.log('DEBUG:', variable);
+console.table(arrayOfObjects);
+console.group('Group');
+console.log('Item 1');
+console.log('Item 2');
+console.groupEnd();
+console.time('Operation');
+// ... operation
+console.timeEnd('Operation');
+```
+
+### Breakpoint Debugging
+
+```typescript
+// Add debugger statement
+function processData(data: Data) {
+  debugger; // Execution pauses here in DevTools
+  return transform(data);
+}
+```
+
+### VS Code Launch Configuration (Angular 14 / Nx 14)
+
+```json
+// .vscode/launch.json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Debug NestJS",
+      "runtimeArgs": ["-r", "ts-node/register"],
+      "args": ["${workspaceFolder}/apps/api/src/main.ts"],
+      "cwd": "${workspaceFolder}"
+    },
+    {
+      "type": "chrome",
+      "request": "launch",
+      "name": "Debug Angular",
+      "url": "http://localhost:4200",
+      "webRoot": "${workspaceFolder}/apps/web/src"
+    }
+  ]
+}
+```
+
+## 5. Error Investigation Workflow
+
+### Step 1: Reproduce
+
+- Get exact steps to reproduce
+- Note environment (browser, Node version - should be Node 18)
+
+### Step 2: Isolate
+
+- Identify component/service causing issue
+- Check if issue is frontend, backend, or database
+
+### Step 3: Trace
+
+- Add logging at key points
+- Use debugger to step through code
+- Check network requests/responses
+
+### Step 4: Root Cause
+
+- Identify the actual cause (not symptoms)
+- Document findings
+
+### Step 5: Fix & Verify
+
+- Apply fix
+- Write test that catches the bug
+- Verify fix doesn't introduce regressions
+
+## 6. Quick Fixes (Angular 14)
+
+### "Cannot read property of undefined"
+
+```typescript
+// Use optional chaining
+const name = user?.profile?.name;
+
+// With nullish coalescing
+const name = user?.profile?.name ?? 'Unknown';
+
+// In templates (Angular 14)
+{{ user?.profile?.name }}
+```
+
+### "Expression has changed after it was checked"
+
+```typescript
+// Option 1: setTimeout
+ngAfterViewInit(): void {
+  setTimeout(() => this.value = newValue);
+}
+
+// Option 2: ChangeDetectorRef
+ngAfterViewInit(): void {
+  this.value = newValue;
+  this.cdr.detectChanges();
+}
+```
+
+### "Circular dependency detected"
+
+```typescript
+// Use forwardRef
+@Inject(forwardRef(() => ServiceB))
+private serviceB: ServiceB
+
+// Or refactor to remove circular dependency
+```
+
+### "NullInjectorError: No provider for X"
+
+```typescript
+// Check module providers
+@NgModule({
+  providers: [MyService], // Add missing provider
+})
+export class AppModule {}
+
+// Or check providedIn
+@Injectable({
+  providedIn: 'root', // Or specific module
+})
+export class MyService {}
+```

package/plugins/flow-legacy/skills/linear-suggestion/SKILL.md

@@ -0,0 +1,132 @@
+---
+name: linear-suggestion
+description: Create a Linear issue in the "MobileMS Framework" project with a suggestion for agent, command, or skill improvements.
+allowed-tools: mcp__linear-server__create_issue
+---
+
+# Linear Suggestion
+
+Create a Linear issue in the **MobileMS Framework** project containing a suggestion for improving agent definitions, commands, or skills. Used by automated analysis agents to propose changes without blocking the workflow.
+
+## When to Use
+
+- When an automated agent (e.g., `shared-parallelization-analyzer`) identifies a recurring pattern that could improve an agent, command, or skill
+- When proposing orchestrator rule changes based on parallelization analysis
+- When any non-interactive process needs to suggest framework improvements
+
+## Input Parameters
+
+The invoking agent must provide:
+
+| Parameter     | Required | Description                                                     |
+| ------------- | -------- | --------------------------------------------------------------- |
+| `title`       | YES      | Short summary of the suggestion (max 100 chars)                 |
+| `description` | YES      | Full markdown description with rationale and proposed changes    |
+| `source`      | YES      | Agent that generated the suggestion (e.g., `shared-parallelization-analyzer`) |
+| `targetFile`  | NO       | Path to the file to be modified (e.g., `agents/shared-impl-orchestrator.md`) |
+| `category`    | NO       | One of: `OPTIMIZATION`, `NEW_RULE`, `PATTERN_UPDATE`, `BUG_FIX` |
+
+## Issue Format
+
+### Title
+
+```
+[Agent Suggestion] {title}
+```
+
+### Description
+
+```markdown
+## Agent Improvement Suggestion
+
+**Source agent**: `{source}`
+**Category**: {category}
+**Target file**: `{targetFile}`
+
+---
+
+{description}
+
+---
+
+_This issue was automatically created by `{source}` via the `linear-suggestion` skill._
+_Review and apply manually if the suggestion is valid._
+```
+
+## Process
+
+1. **Format the issue title** with `[Agent Suggestion]` prefix
+2. **Build the description** using the template above, inserting all provided parameters
+3. **Create the issue** using MCP Linear server:
+
+   ```
+   Create issue in project "MobileMS Framework":
+   - Title: [Agent Suggestion] {title}
+   - Description: {formatted description}
+   - Label: agent-evolution
+   ```
+
+4. **Return the issue ID and URL** to the invoking agent
+
+## Output Format
+
+After successful creation, return:
+
+```
+Linear issue created:
+- ID: {issueId}
+- Title: [Agent Suggestion] {title}
+- URL: {issueUrl}
+```
+
+## Error Handling
+
+If issue creation fails (e.g., MCP Linear server unavailable):
+
+- Log the error silently
+- Do NOT block the parent workflow
+- Return a failure notice without throwing
+
+```
+Linear suggestion skipped: {error reason}
+```
+
+## Example
+
+**Input from `shared-parallelization-analyzer`:**
+
+```
+title: Add parallel scaffolding rule to orchestrator
+description: |
+  ### Observation
+
+  In 3 out of 5 recent tasks, scaffolding agents for independent files
+  (e.g., `angular-component-scaffolder` + `angular-service-builder`) were
+  marked as SEQ despite having no shared output files.
+
+  ### Proposed Change
+
+  Add to `shared-impl-orchestrator.md` -> Execution Patterns -> Parallel vs Sequential:
+
+  | Scenario                                | Pattern  | Reason                          |
+  | --------------------------------------- | -------- | ------------------------------- |
+  | Multiple scaffolding for independent files | PARALLEL | No shared output files between scaffolders |
+
+  ### Evidence
+
+  - MOB-700: scaffold-component + scaffold-service (independent)
+  - MOB-705: scaffold-directive + scaffold-service (independent)
+  - MOB-710: scaffold-component + scaffold-pipe (independent)
+source: shared-parallelization-analyzer
+targetFile: packages/shared/claude-plugins/src/plugins/flow-legacy/agents/shared-impl-orchestrator.md
+category: OPTIMIZATION
+```
+
+**Created issue:**
+
+```
+Linear issue created:
+- ID: MOB-815
+- Title: [Agent Suggestion] Add parallel scaffolding rule to orchestrator
+- URL: https://linear.app/mobilems/issue/MOB-815
+```

package/plugins/flow-legacy/skills/maia-files-delete/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: maia-files-delete
+description: Delete a file from Maia API temporary storage.
+allowed-tools: Bash
+---
+
+# Maia Files Delete
+
+Delete a file from Maia AI API temporary storage to free up space.
+
+## API Endpoint
+
+```
+DELETE https://maia-ai-api.smartsoft.biz.pl/files/{id}
+```
+
+## Usage
+
+When given a file ID or URL, delete it:
+
+```bash
+curl -s -X DELETE https://maia-ai-api.smartsoft.biz.pl/files/{id}
+```
+
+## Process
+
+1. Extract ID from input (can be full URL or just ID)
+2. Send DELETE request
+3. Confirm deletion
+
+## Input Formats
+
+Accept either:
+
+- Full URL: `https://maia-ai-api.smartsoft.biz.pl/files/abc123`
+- Just ID: `abc123`
+
+## Output Format
+
+After successful deletion:
+
+```
+Deleted: {id}
+```
+
+## Batch Deletion
+
+When given multiple IDs, delete them all:
+
+```bash
+for id in id1 id2 id3; do
+  curl -s -X DELETE "https://maia-ai-api.smartsoft.biz.pl/files/$id"
+  echo "Deleted: $id"
+done
+```
+
+## Error Handling
+
+If deletion fails, report the error but continue with remaining files.

package/plugins/flow-legacy/skills/maia-files-upload/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: maia-files-upload
+description: Upload a file to Maia API temporary storage.
+allowed-tools: Bash
+---
+
+# Maia Files Upload
+
+Upload a file to the Maia AI API temporary storage and get a URL for use in Linear comments or markdown.
+
+## API Endpoint
+
+```
+POST https://maia-ai-api.smartsoft.biz.pl/files
+```
+
+## Usage
+
+When given a file path, upload it:
+
+```bash
+curl -s -X POST https://maia-ai-api.smartsoft.biz.pl/files \
+  -F "file=@/path/to/file.png"
+```
+
+## Response
+
+```json
+{ "id": "abc123def456" }
+```
+
+## Result URL
+
+```
+https://maia-ai-api.smartsoft.biz.pl/files/{id}
+```
+
+## Process
+
+1. Validate file exists: `test -f "/path/to/file" && echo "OK"`
+2. Upload file using curl
+3. Extract ID from JSON response
+4. Return ID and full URL
+
+## Output Format
+
+After successful upload, return:
+
+```
+Uploaded: {filename}
+ID: {id}
+URL: https://maia-ai-api.smartsoft.biz.pl/files/{id}
+```
+
+## Error Handling
+
+If file doesn't exist or upload fails, report the error clearly.