plcode-linux-x64-musl 2.1.0

package/.plcode/context/core/context-system/operations/error.md

@@ -0,0 +1,299 @@
+# Error Operation
+
+**Purpose**: Add recurring errors to knowledge base with deduplication
+
+**Last Updated**: 2026-01-06
+
+---
+
+## When to Use
+
+- Encountered same error multiple times
+- Want to document solution for team
+- Building error knowledge base
+- Preventing repeated debugging
+
+---
+
+## 6-Stage Workflow
+
+### Stage 1: Search Existing
+
+**Action**: Search for similar/related errors
+
+**Process**:
+
+1. Search error message across all errors/ files
+2. Find similar errors (fuzzy matching)
+3. Find related errors (same category)
+
+**Format**:
+
+```
+Searching for: "Cannot read property 'map' of undefined"
+
+Found 1 similar error:
+  📄 development/errors/react-errors.md (Line 45)
+     ## Error: Cannot read property 'X' of undefined
+     Covers: General undefined property access
+     Frequency: common
+
+Found 2 related errors:
+  📄 development/errors/react-errors.md
+     ## Error: Cannot read property 'length' of undefined
+     ## Error: Undefined is not an object
+```
+
+---
+
+### Stage 2: Check Duplication (APPROVAL REQUIRED)
+
+**Action**: Present deduplication options
+
+**Format**:
+
+```
+Options:
+  [A] Add as new error to react-errors.md
+      (Specific case: 'map' on undefined array)
+
+  [B] Update existing 'Cannot read property X' error
+      (Add 'map' as common example)
+
+  [C] Skip (already covered sufficiently)
+
+Which framework/category?
+  [1] React (react-errors.md)
+  [2] JavaScript (js-errors.md)
+  [3] General (common-errors.md)
+  [4] Create new: ___
+
+Select option + category (e.g., 'B 1'):
+```
+
+**Validation**: MUST wait for user input
+
+---
+
+### Stage 3: Preview (APPROVAL REQUIRED)
+
+**Action**: Show full error entry before adding
+
+**Format**:
+
+```
+Would update development/errors/react-errors.md:
+
+Current (Line 45):
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+## Error: Cannot read property 'X' of undefined
+
+**Symptom**:
+```
+
+TypeError: Cannot read property 'X' of undefined
+
+````
+
+**Cause**: Attempting to access property on undefined/null object.
+
+**Solution**:
+1. Add null check
+2. Use optional chaining (?.)
+3. Provide default value
+
+**Code**:
+```jsx
+// ❌ Before
+const value = obj.property
+
+// ✅ After
+const value = obj?.property ?? 'default'
+````
+
+**Prevention**: Always validate data exists
+**Frequency**: common
+**Reference**: [Link]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Proposed update:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+## Error: Cannot read property 'X' of undefined
+
+**Symptom**:
+
+```
+TypeError: Cannot read property 'X' of undefined
+TypeError: Cannot read property 'map' of undefined  ← NEW
+TypeError: Cannot read property 'length' of undefined  ← NEW
+```
+
+**Cause**: Attempting to access property on undefined/null object.
+Common with array methods (map, filter) when data hasn't loaded. ← NEW
+
+**Solution**:
+
+1. Add null check
+2. Use optional chaining (?.)
+3. Provide default value (especially for arrays) ← UPDATED
+
+**Code**:
+
+```jsx
+// ❌ Before
+const value = obj.property
+const items = data.map(item => item.name)  ← NEW
+
+// ✅ After
+const value = obj?.property ?? 'default'
+const items = (data || []).map(item => item.name)  ← NEW
+```
+
+**Prevention**: Always validate data exists. For arrays, provide empty array default. ← UPDATED
+**Frequency**: common
+**Reference**: [Link]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+File size: 98 lines → 105 lines (under 150 limit ✓)
+
+Approve? (yes/no/edit):
+
+````
+
+**Edit mode**: Allow modification before adding
+
+**Validation**: MUST get approval before proceeding
+
+---
+
+### Stage 4: Add/Update
+**Action**: Add or update error entry
+
+**Process**:
+1. Add/update error in target file
+2. Follow error template format
+3. Maintain file size <150 lines
+4. Update "Last Updated" date
+
+**Template Format**:
+```markdown
+## Error: {Name}
+
+**Symptom**: [Error message]
+**Cause**: [Why - 1-2 sentences]
+**Solution**: [Steps]
+**Code**: [Before/After example]
+**Prevention**: [How to avoid]
+**Frequency**: common/occasional/rare
+**Reference**: [Link]
+````
+
+---
+
+### Stage 5: Update Navigation
+
+**Action**: Update README.md and add cross-references
+
+**Process**:
+
+1. Update README.md if new file created
+2. Add cross-references to related errors
+3. Link from related concepts/examples
+
+---
+
+### Stage 6: Report
+
+**Action**: Show results
+
+**Format**:
+
+```
+✅ Added error to {category}/errors/{file}.md
+🔗 Cross-referenced with X related errors
+📊 Updated README.md (if needed)
+
+Changes:
+  - Updated existing error entry
+  - Added 'map' and 'length' examples
+  - File size: 105 lines (under 150 limit)
+```
+
+---
+
+## Deduplication Strategy
+
+### Similar Errors
+
+Same root cause, different manifestations
+→ **Update existing** to include new examples
+
+### Related Errors
+
+Different causes, same category
+→ **Cross-reference** between errors
+
+### Duplicate Errors
+
+Exact same error already documented
+→ **Skip** (already covered)
+
+### New Errors
+
+Unique error not yet documented
+→ **Add as new** error entry
+
+---
+
+## Error Grouping
+
+Group errors by framework/topic in single file:
+
+- `react-errors.md` - All React errors
+- `nextjs-errors.md` - All Next.js errors
+- `auth-errors.md` - All authentication errors
+
+**Don't create**: One file per error (too granular)
+
+---
+
+## Examples
+
+### Add New Error
+
+```bash
+/context error for "hooks can only be called inside components"
+```
+
+### Add Common Error
+
+```bash
+/context error for "Cannot read property 'map' of undefined"
+```
+
+### Add Framework Error
+
+```bash
+/context error for "Hydration failed in Next.js"
+```
+
+---
+
+## Success Criteria
+
+- [ ] Searched for similar errors?
+- [ ] Deduplication options presented?
+- [ ] Preview shown?
+- [ ] User approved?
+- [ ] Error follows template format?
+- [ ] File size <150 lines?
+- [ ] Cross-references added?
+- [ ] README.md updated (if new file)?
+
+---
+
+## Related
+
+- standards/templates.md - Error template format
+- guides/workflows.md - Interactive examples

package/.plcode/context/core/context-system/operations/extract.md

@@ -0,0 +1,190 @@
+# Extract Operation
+
+**Purpose**: Extract context from docs, code, or URLs into organized context files
+
+**Last Updated**: 2026-01-06
+
+---
+
+## When to Use
+
+- Extracting from documentation (React docs, API docs, etc.)
+- Extracting from codebase (patterns, conventions)
+- Extracting from URLs (blog posts, guides)
+- Creating initial context for new topics
+
+---
+
+## 7-Stage Workflow
+
+### Stage 1: Read Source
+
+```
+/context extract from https://react.dev/hooks
+  ↓
+Agent: "Reading source (8,500 lines)...
+Analyzing content for extractable items..."
+```
+
+**Action**: Read and analyze source material
+
+---
+
+### Stage 2: Analyze & Categorize
+
+**Action**: Extract and categorize content by function
+
+**Categorization**:
+
+- Design decisions → `concepts/`
+- Working code → `examples/`
+- Step-by-step workflows → `guides/`
+- Reference data (commands, paths) → `lookup/`
+- Errors/gotchas → `errors/`
+
+**Output**: List of extractable items with previews
+
+---
+
+### Stage 3: Select Category (APPROVAL REQUIRED)
+
+**Action**: User chooses target category and items
+
+**Format**:
+
+```
+Found 12 extractable items from {source}:
+
+Concepts (8):
+  ✓ [A] useState - State management hook
+  ✓ [B] useEffect - Side effects hook
+  ... (6 more)
+
+Errors (4):
+  ✓ [I] Hooks called conditionally
+  ✓ [J] Hooks in loops
+  ... (2 more)
+
+Which category?
+  [1] development/
+  [2] core/
+  [3] Create new category: ___
+
+Select items (A B I or 'all') + category (1/2/3):
+```
+
+**Validation**: MUST wait for user input before proceeding
+
+---
+
+### Stage 4: Preview (APPROVAL REQUIRED)
+
+**Action**: Show what will be created
+
+**Format**:
+
+```
+Would create in development/:
+
+  concepts/use-state.md (45 lines)
+  concepts/use-effect.md (52 lines)
+  errors/react-hooks-errors.md (124 lines)
+
+Total: 12 files, ~650 lines
+
+Preview file? (type filename or 'skip')
+Approve? (yes/no/preview):
+```
+
+**If user types filename**: Show first 30 lines of that file
+
+**Validation**: MUST get approval before proceeding
+
+---
+
+### Stage 5: Create
+
+**Action**: Create files in function folders
+
+**Process**:
+
+1. Apply MVI format (1-3 sentences, 3-5 key points, minimal example)
+2. Create files in correct function folders
+3. Ensure all files <200 lines
+4. Add cross-references
+
+**Enforcement**: `@critical_rules.mvi_strict` + `@critical_rules.function_structure`
+
+---
+
+### Stage 6: Update Navigation
+
+**Action**: Update README.md and add cross-references
+
+**Process**:
+
+1. Update category README.md with new files
+2. Add priority levels (critical/high/medium/low)
+3. Add cross-references between related files
+4. Update "Last Updated" dates
+
+---
+
+### Stage 7: Report
+
+**Action**: Show comprehensive results
+
+**Format**:
+
+```
+✅ Extracted X items into {category}
+📄 Created Y files
+📊 Updated {category}/README.md
+
+Files created:
+  - {category}/concepts/ (N files)
+  - {category}/examples/ (N files)
+  - {category}/errors/ (N files)
+```
+
+---
+
+## Examples
+
+### Extract from URL
+
+```bash
+/context extract from https://react.dev/hooks
+```
+
+### Extract from Local Docs
+
+```bash
+/context extract from docs/api.md
+/context extract from docs/architecture/
+```
+
+### Extract from Code
+
+```bash
+/context extract from src/utils/
+```
+
+---
+
+## Success Criteria
+
+- [ ] All files <200 lines?
+- [ ] MVI format applied (1-3 sentences, 3-5 points, example, reference)?
+- [ ] Files in correct function folders?
+- [ ] README.md updated?
+- [ ] Cross-references added?
+- [ ] User approved before creation?
+
+---
+
+## Related
+
+- standards/mvi.md - What to extract
+- guides/compact.md - How to minimize
+- guides/workflows.md - Interactive examples