@smartsoft001-mobilems/claude-plugins 2.58.0

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

@@ -0,0 +1,375 @@
+---
+name: debug-helper
+description: Cross-stack debugging workflows for Angular, NestJS, and MongoDB applications
+---
+
+# Debug Helper
+
+This skill provides debugging workflows and techniques for this project's tech stack.
+
+## 1. Angular Debugging
+
+### Component Not Rendering
+
+1. **Check selector usage**
+
+   ```typescript
+   // Verify selector matches
+   @Component({ selector: 'app-my-component' })
+   // Template: <app-my-component />
+   ```
+
+2. **Check imports (standalone)**
+
+   ```typescript
+   @Component({
+     standalone: true,
+     imports: [MyComponent], // Is it imported?
+   })
+   ```
+
+3. **Check module exports (non-standalone)**
+   ```typescript
+   @NgModule({
+     exports: [MyComponent], // Is it exported?
+   })
+   ```
+
+### Signal/Reactive Issues
+
+1. **Signal not updating**
+
+   ```typescript
+   // Wrong: mutating object
+   items()[0].name = 'new'; // Won't trigger update
+
+   // Correct: create new reference
+   items.update((arr) =>
+     arr.map((item) => (item.id === id ? { ...item, name: 'new' } : item)),
+   );
+   ```
+
+2. **Effect not running**
+
+   ```typescript
+   // Ensure signal is read inside effect
+   effect(() => {
+     const value = this.mySignal(); // Must call signal
+     console.log('Value changed:', value);
+   });
+   ```
+
+3. **Computed not recalculating**
+   ```typescript
+   // Ensure all dependencies are read
+   readonly filtered = computed(() => {
+     const items = this.items();    // Dependency
+     const filter = this.filter();  // Dependency
+     return items.filter(i => i.name.includes(filter));
+   });
+   ```
+
+### Change Detection Issues
+
+```typescript
+// Force change detection
+constructor(private cdr: ChangeDetectorRef) {}
+
+// After async operation
+this.cdr.detectChanges();
+
+// Or mark for check (OnPush)
+this.cdr.markForCheck();
+```
+
+### HTTP Debugging
+
+```typescript
+// Add HTTP interceptor for logging
+export const loggingInterceptor: HttpInterceptorFn = (req, next) => {
+  console.log('Request:', req.method, req.url);
+  return next(req).pipe(
+    tap({
+      next: (event) => {
+        if (event instanceof HttpResponse) {
+          console.log('Response:', event.status, event.body);
+        }
+      },
+      error: (error) => console.error('HTTP Error:', error),
+    }),
+  );
+};
+```
+
+### Browser DevTools
+
+1. **Angular DevTools** - Install Chrome extension
+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);
+  }
+}
+```
+
+### Exception Debugging
+
+```typescript
+// Global exception filter
+@Catch()
+export class AllExceptionsFilter implements ExceptionFilter {
+  private readonly logger = new Logger('ExceptionFilter');
+
+  catch(exception: unknown, host: ArgumentsHost) {
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse();
+    const request = ctx.getRequest();
+
+    this.logger.error(
+      `${request.method} ${request.url}`,
+      exception instanceof Error ? exception.stack : exception,
+    );
+
+    // Return error response
+  }
+}
+```
+
+## 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());
+```
+
+### Aggregation Debugging
+
+```typescript
+// Log pipeline
+const pipeline = [
+  { $match: { status: 'active' } },
+  { $group: { _id: '$category', count: { $sum: 1 } } },
+];
+console.log('Pipeline:', JSON.stringify(pipeline, null, 2));
+
+// Explain query
+const explanation = await this.model.aggregate(pipeline).explain();
+console.log('Explain:', explanation);
+```
+
+### Index Issues
+
+```bash
+# Check indexes in MongoDB shell
+db.features.getIndexes()
+
+# Check query uses index
+db.features.find({ status: 'active' }).explain('executionStats')
+```
+
+## 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
+
+```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:4210",
+      "webRoot": "${workspaceFolder}/apps/web/src"
+    }
+  ]
+}
+```
+
+## 5. Error Investigation Workflow
+
+### Step 1: Reproduce
+
+- Get exact steps to reproduce
+- Note environment (browser, Node version)
+
+### 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
+
+### "Cannot read property of undefined"
+
+```typescript
+// Use optional chaining
+const name = user?.profile?.name;
+
+// With nullish coalescing
+const name = user?.profile?.name ?? 'Unknown';
+```
+
+### "Expression has changed after it was checked"
+
+```typescript
+// Option 1: setTimeout
+ngAfterViewInit() {
+  setTimeout(() => this.value = newValue);
+}
+
+// Option 2: ChangeDetectorRef
+ngAfterViewInit() {
+  this.value = newValue;
+  this.cdr.detectChanges();
+}
+```
+
+### "Circular dependency detected"
+
+```typescript
+// Use forwardRef
+@Inject(forwardRef(() => ServiceB))
+private serviceB: ServiceB
+
+// Or refactor to remove circular dependency
+```

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

@@ -0,0 +1,60 @@
+---
+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/skills/maia-files-upload/SKILL.md

@@ -0,0 +1,58 @@
+---
+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.