aigroup-workflow 2.2.1 → 2.2.3

package/skills/backend/debugging-wizard/references/debugging-tools.md

@@ -1,140 +1,140 @@
-# Debugging Tools
-
-## Debuggers by Language
-
-| Language | Debugger | Start Command |
-|----------|----------|---------------|
-| TypeScript/JS | Node Inspector | `node --inspect` |
-| Python | pdb/ipdb | `python -m pdb` |
-| Go | Delve | `dlv debug` |
-| Rust | rust-gdb/lldb | `rust-gdb ./target/debug/app` |
-| Java | JDB/IDE | IDE debugger |
-
-## Node.js / TypeScript
-
-```bash
-# Start with inspector
-node --inspect dist/main.js
-
-# Break on first line
-node --inspect-brk dist/main.js
-
-# With ts-node
-node --inspect -r ts-node/register src/main.ts
-```
-
-```typescript
-// In code
-debugger; // Breakpoint
-
-// Quick print
-console.log({ variable }); // Shows name and value
-console.table(arrayOfObjects); // Table format
-console.trace('Called from'); // Stack trace
-```
-
-## Python
-
-```bash
-# Start debugger
-python -m pdb script.py
-
-# Post-mortem on exception
-python -m pdb -c continue script.py
-```
-
-```python
-# In code
-breakpoint()  # Python 3.7+
-import pdb; pdb.set_trace()  # Older Python
-
-# Quick print
-print(f"{variable=}")  # Python 3.8+ shows name and value
-
-# Rich debugging
-from rich import inspect
-inspect(object, methods=True)
-```
-
-### pdb Commands
-
-| Command | Action |
-|---------|--------|
-| `n` | Next line |
-| `s` | Step into |
-| `c` | Continue |
-| `l` | List code |
-| `p expr` | Print expression |
-| `pp expr` | Pretty print |
-| `w` | Where (stack) |
-| `q` | Quit |
-
-## Go
-
-```bash
-# Start delve
-dlv debug ./cmd/app
-
-# Attach to running process
-dlv attach <pid>
-
-# Debug test
-dlv test ./pkg/...
-```
-
-```go
-// Quick print
-log.Printf("%+v", variable) // With field names
-fmt.Printf("%#v\n", variable) // Go syntax representation
-
-// Spew for complex structures
-import "github.com/davecgh/go-spew/spew"
-spew.Dump(variable)
-```
-
-### Delve Commands
-
-| Command | Action |
-|---------|--------|
-| `break main.go:42` | Set breakpoint |
-| `continue` | Continue |
-| `next` | Next line |
-| `step` | Step into |
-| `print var` | Print variable |
-| `goroutines` | List goroutines |
-
-## VS Code Debug Config
-
-```json
-// .vscode/launch.json
-{
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Debug TypeScript",
-      "program": "${workspaceFolder}/src/main.ts",
-      "preLaunchTask": "tsc: build",
-      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
-    },
-    {
-      "type": "python",
-      "request": "launch",
-      "name": "Debug Python",
-      "program": "${workspaceFolder}/main.py",
-      "console": "integratedTerminal"
-    }
-  ]
-}
-```
-
-## Quick Reference
-
-| Need | Tool |
-|------|------|
-| Breakpoint in code | `debugger;` / `breakpoint()` |
-| Print with name | `console.log({x})` / `print(f"{x=}")` |
-| Stack trace | `console.trace()` / `traceback.print_stack()` |
-| Inspect object | `console.dir(obj)` / `dir(obj)` |
-| Step through | IDE debugger or CLI debugger |
+# Debugging Tools
+
+## Debuggers by Language
+
+| Language | Debugger | Start Command |
+|----------|----------|---------------|
+| TypeScript/JS | Node Inspector | `node --inspect` |
+| Python | pdb/ipdb | `python -m pdb` |
+| Go | Delve | `dlv debug` |
+| Rust | rust-gdb/lldb | `rust-gdb ./target/debug/app` |
+| Java | JDB/IDE | IDE debugger |
+
+## Node.js / TypeScript
+
+```bash
+# Start with inspector
+node --inspect dist/main.js
+
+# Break on first line
+node --inspect-brk dist/main.js
+
+# With ts-node
+node --inspect -r ts-node/register src/main.ts
+```
+
+```typescript
+// In code
+debugger; // Breakpoint
+
+// Quick print
+console.log({ variable }); // Shows name and value
+console.table(arrayOfObjects); // Table format
+console.trace('Called from'); // Stack trace
+```
+
+## Python
+
+```bash
+# Start debugger
+python -m pdb script.py
+
+# Post-mortem on exception
+python -m pdb -c continue script.py
+```
+
+```python
+# In code
+breakpoint()  # Python 3.7+
+import pdb; pdb.set_trace()  # Older Python
+
+# Quick print
+print(f"{variable=}")  # Python 3.8+ shows name and value
+
+# Rich debugging
+from rich import inspect
+inspect(object, methods=True)
+```
+
+### pdb Commands
+
+| Command | Action |
+|---------|--------|
+| `n` | Next line |
+| `s` | Step into |
+| `c` | Continue |
+| `l` | List code |
+| `p expr` | Print expression |
+| `pp expr` | Pretty print |
+| `w` | Where (stack) |
+| `q` | Quit |
+
+## Go
+
+```bash
+# Start delve
+dlv debug ./cmd/app
+
+# Attach to running process
+dlv attach <pid>
+
+# Debug test
+dlv test ./pkg/...
+```
+
+```go
+// Quick print
+log.Printf("%+v", variable) // With field names
+fmt.Printf("%#v\n", variable) // Go syntax representation
+
+// Spew for complex structures
+import "github.com/davecgh/go-spew/spew"
+spew.Dump(variable)
+```
+
+### Delve Commands
+
+| Command | Action |
+|---------|--------|
+| `break main.go:42` | Set breakpoint |
+| `continue` | Continue |
+| `next` | Next line |
+| `step` | Step into |
+| `print var` | Print variable |
+| `goroutines` | List goroutines |
+
+## VS Code Debug Config
+
+```json
+// .vscode/launch.json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Debug TypeScript",
+      "program": "${workspaceFolder}/src/main.ts",
+      "preLaunchTask": "tsc: build",
+      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
+    },
+    {
+      "type": "python",
+      "request": "launch",
+      "name": "Debug Python",
+      "program": "${workspaceFolder}/main.py",
+      "console": "integratedTerminal"
+    }
+  ]
+}
+```
+
+## Quick Reference
+
+| Need | Tool |
+|------|------|
+| Breakpoint in code | `debugger;` / `breakpoint()` |
+| Print with name | `console.log({x})` / `print(f"{x=}")` |
+| Stack trace | `console.trace()` / `traceback.print_stack()` |
+| Inspect object | `console.dir(obj)` / `dir(obj)` |
+| Step through | IDE debugger or CLI debugger |

package/skills/backend/debugging-wizard/references/quick-fixes.md

@@ -1,177 +1,177 @@
-# Quick Fixes
-
-## TypeError: Cannot read property 'x' of undefined
-
-```typescript
-// Error
-user.profile.name
-// user or profile is undefined
-
-// Fix: Optional chaining
-user?.profile?.name
-
-// Fix: Default value
-user?.profile?.name ?? 'Unknown'
-
-// Fix: Guard clause
-if (!user?.profile) {
-  return null;
-}
-return user.profile.name;
-```
-
-## Unhandled Promise Rejection
-
-```typescript
-// Error
-fetchData().then(process);
-// What if fetchData rejects?
-
-// Fix: Add catch
-fetchData()
-  .then(process)
-  .catch(error => {
-    console.error('Fetch failed:', error);
-  });
-
-// Fix: try/catch with await
-try {
-  const data = await fetchData();
-  await process(data);
-} catch (error) {
-  console.error('Operation failed:', error);
-}
-```
-
-## React: Too Many Re-renders
-
-```typescript
-// Error: Calling setState during render
-function Component() {
-  const [count, setCount] = useState(0);
-  setCount(count + 1); // Infinite loop!
-}
-
-// Fix: Use useEffect for side effects
-function Component() {
-  const [count, setCount] = useState(0);
-  useEffect(() => {
-    setCount(c => c + 1);
-  }, []); // Only on mount
-}
-
-// Error: Object/array in dependency array
-useEffect(() => {}, [{ a: 1 }]); // New object every render!
-
-// Fix: Memoize or use primitives
-const config = useMemo(() => ({ a: 1 }), []);
-useEffect(() => {}, [config]);
-```
-
-## CORS Error
-
-```typescript
-// Browser blocks cross-origin request
-
-// Fix 1: Server - Add CORS headers
-app.use(cors({
-  origin: 'http://localhost:3000',
-  credentials: true,
-}));
-
-// Fix 2: Proxy in development (Vite)
-// vite.config.ts
-export default {
-  server: {
-    proxy: {
-      '/api': 'http://localhost:8000',
-    },
-  },
-};
-```
-
-## Maximum Call Stack Size Exceeded
-
-```typescript
-// Error: Infinite recursion
-function factorial(n) {
-  return n * factorial(n - 1); // No base case!
-}
-
-// Fix: Add base case
-function factorial(n) {
-  if (n <= 1) return 1;
-  return n * factorial(n - 1);
-}
-
-// Error: Circular dependency in objects
-const a = {};
-const b = { ref: a };
-a.ref = b;
-JSON.stringify(a); // Fails!
-
-// Fix: Break circular reference
-JSON.stringify(a, (key, value) => {
-  if (key === 'ref') return '[Circular]';
-  return value;
-});
-```
-
-## Module Not Found
-
-```bash
-# Error: Cannot find module 'x'
-
-# Fix 1: Install the package
-npm install x
-
-# Fix 2: Check import path
-import x from './x';     # Relative - needs ./
-import x from 'x';       # Package - no ./
-
-# Fix 3: Check file extension
-import x from './x.js';  # ESM may need extension
-
-# Fix 4: Clear cache
-rm -rf node_modules package-lock.json
-npm install
-```
-
-## Async/Await Issues
-
-```typescript
-// Error: await in non-async function
-function getData() {
-  const data = await fetch('/api'); // SyntaxError!
-}
-
-// Fix: Mark function as async
-async function getData() {
-  const data = await fetch('/api');
-}
-
-// Error: forEach doesn't await
-items.forEach(async item => {
-  await process(item); // Doesn't wait!
-});
-
-// Fix: Use for...of
-for (const item of items) {
-  await process(item);
-}
-
-// Fix: Use Promise.all for parallel
-await Promise.all(items.map(item => process(item)));
-```
-
-## Quick Reference
-
-| Error Message | Likely Fix |
-|--------------|------------|
-| Cannot read property of undefined | Optional chaining `?.` |
-| Unhandled promise rejection | Add `.catch()` or try/catch |
-| Too many re-renders | Remove setState from render |
-| CORS error | Add CORS headers on server |
-| Maximum call stack | Add recursion base case |
-| Module not found | Check path, install package |
-| await in non-async | Add `async` keyword |
+# Quick Fixes
+
+## TypeError: Cannot read property 'x' of undefined
+
+```typescript
+// Error
+user.profile.name
+// user or profile is undefined
+
+// Fix: Optional chaining
+user?.profile?.name
+
+// Fix: Default value
+user?.profile?.name ?? 'Unknown'
+
+// Fix: Guard clause
+if (!user?.profile) {
+  return null;
+}
+return user.profile.name;
+```
+
+## Unhandled Promise Rejection
+
+```typescript
+// Error
+fetchData().then(process);
+// What if fetchData rejects?
+
+// Fix: Add catch
+fetchData()
+  .then(process)
+  .catch(error => {
+    console.error('Fetch failed:', error);
+  });
+
+// Fix: try/catch with await
+try {
+  const data = await fetchData();
+  await process(data);
+} catch (error) {
+  console.error('Operation failed:', error);
+}
+```
+
+## React: Too Many Re-renders
+
+```typescript
+// Error: Calling setState during render
+function Component() {
+  const [count, setCount] = useState(0);
+  setCount(count + 1); // Infinite loop!
+}
+
+// Fix: Use useEffect for side effects
+function Component() {
+  const [count, setCount] = useState(0);
+  useEffect(() => {
+    setCount(c => c + 1);
+  }, []); // Only on mount
+}
+
+// Error: Object/array in dependency array
+useEffect(() => {}, [{ a: 1 }]); // New object every render!
+
+// Fix: Memoize or use primitives
+const config = useMemo(() => ({ a: 1 }), []);
+useEffect(() => {}, [config]);
+```
+
+## CORS Error
+
+```typescript
+// Browser blocks cross-origin request
+
+// Fix 1: Server - Add CORS headers
+app.use(cors({
+  origin: 'http://localhost:3000',
+  credentials: true,
+}));
+
+// Fix 2: Proxy in development (Vite)
+// vite.config.ts
+export default {
+  server: {
+    proxy: {
+      '/api': 'http://localhost:8000',
+    },
+  },
+};
+```
+
+## Maximum Call Stack Size Exceeded
+
+```typescript
+// Error: Infinite recursion
+function factorial(n) {
+  return n * factorial(n - 1); // No base case!
+}
+
+// Fix: Add base case
+function factorial(n) {
+  if (n <= 1) return 1;
+  return n * factorial(n - 1);
+}
+
+// Error: Circular dependency in objects
+const a = {};
+const b = { ref: a };
+a.ref = b;
+JSON.stringify(a); // Fails!
+
+// Fix: Break circular reference
+JSON.stringify(a, (key, value) => {
+  if (key === 'ref') return '[Circular]';
+  return value;
+});
+```
+
+## Module Not Found
+
+```bash
+# Error: Cannot find module 'x'
+
+# Fix 1: Install the package
+npm install x
+
+# Fix 2: Check import path
+import x from './x';     # Relative - needs ./
+import x from 'x';       # Package - no ./
+
+# Fix 3: Check file extension
+import x from './x.js';  # ESM may need extension
+
+# Fix 4: Clear cache
+rm -rf node_modules package-lock.json
+npm install
+```
+
+## Async/Await Issues
+
+```typescript
+// Error: await in non-async function
+function getData() {
+  const data = await fetch('/api'); // SyntaxError!
+}
+
+// Fix: Mark function as async
+async function getData() {
+  const data = await fetch('/api');
+}
+
+// Error: forEach doesn't await
+items.forEach(async item => {
+  await process(item); // Doesn't wait!
+});
+
+// Fix: Use for...of
+for (const item of items) {
+  await process(item);
+}
+
+// Fix: Use Promise.all for parallel
+await Promise.all(items.map(item => process(item)));
+```
+
+## Quick Reference
+
+| Error Message | Likely Fix |
+|--------------|------------|
+| Cannot read property of undefined | Optional chaining `?.` |
+| Unhandled promise rejection | Add `.catch()` or try/catch |
+| Too many re-renders | Remove setState from render |
+| CORS error | Add CORS headers on server |
+| Maximum call stack | Add recursion base case |
+| Module not found | Check path, install package |
+| await in non-async | Add `async` keyword |