@yuaone/core 0.8.5 → 0.9.0

package/dist/skill-loader.js

@@ -7,6 +7,41 @@
  * - Match skill triggers against runtime context
  * - Load local skills from .yuan/skills/ directory
  */
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+// Built-in skills shipped with @yuaone/core
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export const BUILTIN_SKILLS_PATH = join(__dirname, "skills");
+// ─── Multilingual field alias map ───
+/** Map of lowercase field label → canonical key */
+const FIELD_ALIASES = {
+    // Symptom
+    symptom: "symptom",
+    symptoms: "symptom",
+    "증상": "symptom",
+    // Cause
+    cause: "cause",
+    causes: "cause",
+    "원인": "cause",
+    // Strategy
+    strategy: "strategy",
+    solution: "strategy",
+    fix: "strategy",
+    "전략": "strategy",
+    "해결": "strategy",
+    // Tool sequence
+    "tool sequence": "toolSequence",
+    tool_sequence: "toolSequence",
+    tools: "toolSequence",
+    "도구 시퀀스": "toolSequence",
+    "도구": "toolSequence",
+    // Pitfall
+    pitfall: "pitfall",
+    pitfalls: "pitfall",
+    warning: "pitfall",
+    "함정": "pitfall",
+    "주의": "pitfall",
+};
 export class SkillLoader {
     /**
      * Match + parse in one pass.
@@ -124,25 +159,19 @@ export class SkillLoader {
         return result;
     }
     /**
-     * Parse ### Known Error Patterns subsections.
+     * Parse ### pattern subsections under any H2 with "pattern", "error",
+     * "known", "패턴", or "에러" in the heading (case-insensitive).
      *
-     * Expected format:
-     * ```
-     * ### Pattern Name
-     * - **증상**: "..."
-     * - **원인**: ...
-     * - **전략**: 1. ... 2. ...
-     * - **도구 시퀀스**: grep → file_read → ...
-     * - **함정**: ...
-     * ```
+     * Fields inside each block are parsed via language-agnostic `**Label:**`
+     * detection and normalized through FIELD_ALIASES.
      */
     parseKnownPatterns(content) {
         const patterns = [];
-        // Find sections that start with ### under ## Known Error Patterns
-        const knownSection = content.match(/## Known (?:Error )?Patterns\s*\n([\s\S]*?)(?=\n## |\n---|$)/);
-        if (!knownSection)
+        // Match any H2 heading that contains pattern/error/known keywords (multilingual)
+        const sectionMatch = content.match(/## [^\n]*(?:pattern|error|known|패턴|에러)[^\n]*\s*\n([\s\S]*?)(?=\n## |\n---|$)/i);
+        if (!sectionMatch)
             return patterns;
-        const sectionContent = knownSection[1];
+        const sectionContent = sectionMatch[1];
         // Split by ### headers
         const subsections = sectionContent.split(/\n### /).filter(Boolean);
         for (const sub of subsections) {
@@ -151,13 +180,49 @@ export class SkillLoader {
             if (!name)
                 continue;
             const body = lines.slice(1).join("\n");
+            // Parse all **Label:** or **Label**: fields in a language-agnostic way
+            const fieldMap = {};
+            const fieldRegex = /\*\*([^*]+)\*\*:?\s*(.+)/g;
+            let m;
+            while ((m = fieldRegex.exec(body)) !== null) {
+                const rawLabel = m[1].trim().toLowerCase();
+                const canonical = FIELD_ALIASES[rawLabel];
+                if (canonical) {
+                    fieldMap[canonical] = m[2].trim();
+                }
+            }
+            const parseFieldList = (key) => {
+                const val = fieldMap[key];
+                if (!val)
+                    return [];
+                const quoted = val.match(/"([^"]+)"/);
+                if (quoted)
+                    return [quoted[1]];
+                return val.split(/,|;/).map((s) => s.trim()).filter(Boolean);
+            };
+            const parseToolSeqField = (key) => {
+                const val = fieldMap[key];
+                if (!val)
+                    return [];
+                return val.split(/→|->|,/).map((t) => t.trim()).filter(Boolean);
+            };
+            const parseNumberedField = (key) => {
+                const val = fieldMap[key];
+                if (!val)
+                    return [];
+                // Try numbered items first
+                const numbered = [...val.matchAll(/\d+\.\s*(.+)/g)].map((x) => x[1].trim());
+                if (numbered.length > 0)
+                    return numbered;
+                return val.split(/,|;/).map((s) => s.trim()).filter(Boolean);
+            };
             const pattern = {
                 name,
-                symptoms: this.extractListItems(body, /\*\*증상\*\*[:\s]*/i),
-                causes: this.extractListItems(body, /\*\*원인\*\*[:\s]*/i),
-                strategy: this.extractNumberedItems(body, /\*\*전략\*\*[:\s]*/i),
-                tools: this.extractToolSequence(body),
-                pitfalls: this.extractListItems(body, /\*\*함정\*\*[:\s]*/i),
+                symptoms: parseFieldList("symptom"),
+                causes: parseFieldList("cause"),
+                strategy: parseNumberedField("strategy"),
+                tools: parseToolSeqField("toolSequence"),
+                pitfalls: parseFieldList("pitfall"),
             };
             patterns.push(pattern);
         }
@@ -196,20 +261,24 @@ export class SkillLoader {
     /**
      * Score how well a skill matches the given context.
      * Returns 0 for no match, higher for better match.
+     * Evaluates trigger.requires and trigger.exclude as hard gates.
      */
     scoreTriggerMatch(skill, context) {
         const trigger = skill.trigger;
+        let rawScore = 0;
         switch (trigger.kind) {
             case "file_pattern": {
                 if (!context.filePath || !trigger.pattern)
                     return 0;
-                return this.globMatch(trigger.pattern, context.filePath) ? 1 : 0;
+                rawScore = this.globMatch(trigger.pattern, context.filePath) ? 1 : 0;
+                break;
             }
             case "command": {
                 if (!context.command || !trigger.command)
                     return 0;
                 const cmd = context.command.replace(/^\//, "");
-                return cmd === trigger.command ? 10 : 0; // High score for exact command match
+                rawScore = cmd === trigger.command ? 10 : 0; // High score for exact command match
+                break;
             }
             case "auto": {
                 let score = 0;
@@ -240,48 +309,43 @@ export class SkillLoader {
                         }
                     }
                 }
-                return score;
+                rawScore = score;
+                break;
             }
             case "manual":
                 return 0;
             default:
                 return 0;
         }
-    }
-    // ─── Utility Helpers ───
-    /**
-     * Extract list items following a marker pattern.
-     */
-    extractListItems(content, markerPattern) {
-        const match = content.match(new RegExp(markerPattern.source + "(.+)", "i"));
-        if (!match)
-            return [];
-        const text = match[1].trim();
-        // Handle quoted content
-        const quoted = text.match(/"([^"]+)"/);
-        if (quoted)
-            return [quoted[1]];
-        // Handle comma-separated
-        return text
-            .split(/,|;/)
-            .map((s) => s.trim())
-            .filter(Boolean);
+        // Bug Fix 3: evaluate requires/exclude as hard gates
+        return this.applyRequiresExclude(trigger, context, rawScore);
     }
     /**
-     * Extract numbered items (1. ... 2. ... 3. ...).
+     * Evaluate trigger.requires and trigger.exclude against context.
+     * Returns the adjusted score (0 = hard block, otherwise original score).
      */
-    extractNumberedItems(content, markerPattern) {
-        const markerMatch = content.match(new RegExp(markerPattern.source + "[\\s\\S]*?(?=\\n- \\*\\*|$)", "i"));
-        if (!markerMatch)
-            return [];
-        const section = markerMatch[0];
-        const items = [];
-        const matches = section.matchAll(/\d+\.\s*(.+)/g);
-        for (const match of matches) {
-            items.push(match[1].trim());
+    applyRequiresExclude(trigger, context, score) {
+        if (score === 0)
+            return 0;
+        const ctx = [context.filePath, context.errorMessage, context.taskDescription]
+            .filter(Boolean)
+            .join(" ")
+            .toLowerCase();
+        // requires: ALL items must be present in context
+        if (trigger.requires?.length) {
+            const allPresent = trigger.requires.every((req) => ctx.includes(req.toLowerCase()));
+            if (!allPresent)
+                return 0; // Hard block — required context missing
         }
-        return items;
+        // exclude: if ANY exclusion pattern matches, skip this skill
+        if (trigger.exclude?.length) {
+            const anyExcluded = trigger.exclude.some((exc) => ctx.includes(exc.toLowerCase()));
+            if (anyExcluded)
+                return 0; // Hard block — exclusion matched
+        }
+        return score;
     }
+    // ─── Utility Helpers ───
     /**
      * Extract tool sequence from a pattern section.
      */

package/dist/skill-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"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"}

package/dist/skill-mode-bridge.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module skill-mode-bridge
+ * @description Maps built-in skill IDs to their corresponding AgentMode values.
+ *
+ * When a skill is enabled via `/skills enable <id>`, the CLI can use this map
+ * to also apply the corresponding agent mode, giving the LLM the right
+ * system-prompt suffix and tool restrictions for that skill's domain.
+ */
+import type { AgentMode } from "./agent-modes.js";
+/** Map from built-in skill ID to the AgentMode it corresponds to. */
+export declare const SKILL_TO_MODE: Record<string, AgentMode>;
+/**
+ * Resolve the AgentMode for a given skill ID.
+ * Returns undefined if the skill has no mode mapping.
+ */
+export declare function skillToMode(skillId: string): AgentMode | undefined;
+//# sourceMappingURL=skill-mode-bridge.d.ts.map

package/dist/skill-mode-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mode-bridge.d.ts","sourceRoot":"","sources":["../src/skill-mode-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CASnD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAElE"}

package/dist/skill-mode-bridge.js

@@ -0,0 +1,27 @@
+/**
+ * @module skill-mode-bridge
+ * @description Maps built-in skill IDs to their corresponding AgentMode values.
+ *
+ * When a skill is enabled via `/skills enable <id>`, the CLI can use this map
+ * to also apply the corresponding agent mode, giving the LLM the right
+ * system-prompt suffix and tool restrictions for that skill's domain.
+ */
+/** Map from built-in skill ID to the AgentMode it corresponds to. */
+export const SKILL_TO_MODE = {
+    "code-review": "review",
+    "security-scan": "security",
+    "test-driven": "test",
+    "test-gen": "test",
+    refactor: "refactor",
+    debug: "debug",
+    plan: "plan",
+    architect: "architect",
+};
+/**
+ * Resolve the AgentMode for a given skill ID.
+ * Returns undefined if the skill has no mode mapping.
+ */
+export function skillToMode(skillId) {
+    return SKILL_TO_MODE[skillId];
+}
+//# sourceMappingURL=skill-mode-bridge.js.map

package/dist/skill-mode-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mode-bridge.js","sourceRoot":"","sources":["../src/skill-mode-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAA8B;IACtD,aAAa,EAAE,QAAQ;IACvB,eAAe,EAAE,UAAU;IAC3B,aAAa,EAAE,MAAM;IACrB,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/skills/code-review.md

@@ -0,0 +1,58 @@
+## Identity
+- domain: general
+- type: review
+- confidence: 0.95
+
+# Code Review — Correctness, Security, Performance
+
+Review in priority order: Correctness → Security → Performance → Style.
+Style comments without correctness/security concerns are noise.
+
+## Severity Levels
+- **CRITICAL** — Will cause data loss, security breach, or crash in production. Must fix before merge.
+- **HIGH** — Likely bug under realistic conditions. Fix before merge.
+- **MEDIUM** — Potential issue under edge cases. Fix recommended.
+- **LOW** — Style, readability, minor improvement. Optional.
+
+## Review Checklist
+
+### Correctness
+- [ ] Does the logic match the intended behavior?
+- [ ] Are all edge cases handled (null, empty, boundary)?
+- [ ] Are error conditions handled or explicitly ignored?
+- [ ] Are async operations awaited where needed?
+- [ ] Are race conditions possible?
+
+### Security
+- [ ] User input validated and sanitized before use?
+- [ ] No string interpolation into SQL/shell/HTML?
+- [ ] No secrets, API keys, or credentials in code?
+- [ ] File paths validated to prevent traversal?
+- [ ] Permissions checked before operations?
+
+### Performance
+- [ ] No N+1 queries in loops?
+- [ ] No unbounded operations on user-controlled input size?
+- [ ] Expensive operations cached where appropriate?
+
+## Known Error Patterns
+
+### Logic Bug — Off By One
+- **Symptom**: Array access, loop bounds, or range checks produce wrong results at edges
+- **Cause**: < vs <=, 0 vs 1 as start index, missing last element
+- **Strategy**: Test with length=0, length=1, and at-boundary inputs
+- **Tool sequence**: file_read → grep (similar patterns) → file_edit
+- **Pitfall**: Do NOT approve logic that was not tested at its boundaries.
+
+### Silent Failure
+- **Symptom**: Function catches error and returns undefined/null/false without logging
+- **Cause**: catch block swallows errors
+- **Strategy**: Flag all catch blocks that do not log or rethrow
+- **Tool sequence**: grep (catch) → file_read → comment
+- **Pitfall**: Do NOT approve silent error suppression in production code paths.
+
+## Validation Checklist
+- [ ] All CRITICAL issues flagged
+- [ ] All HIGH issues flagged
+- [ ] Security review completed
+- [ ] Review output formatted as severity-labeled list

package/dist/skills/debug.md

@@ -0,0 +1,45 @@
+## Identity
+- domain: general
+- type: debug
+- confidence: 0.9
+
+# Debug — Reproduce, Trace, Fix, Verify
+
+Always reproduce the bug before touching any code. A fix you can't verify didn't happen.
+
+## Workflow
+1. **Reproduce** — Write a minimal script or test that triggers the bug. Run it. Confirm it fails.
+2. **Trace** — Read the error message completely. Find the deepest frame in YOUR code (not library internals). Read that file.
+3. **Localize** — Grep for the function/symbol in the error. Read 3 levels of call hierarchy.
+4. **Fix** — Smallest change that resolves the root cause. Not the symptom.
+5. **Verify** — Rerun the reproduction script. Run full test suite. Confirm no regressions.
+
+## Known Error Patterns
+
+### Fixing the Wrong Location
+- **Symptom**: Fix applied, error persists or appears elsewhere
+- **Cause**: Patched a caller when the bug is in the callee, or patched a copy/subclass instead of the source
+- **Strategy**: 1. Grep all files containing the error pattern 2. Read the deepest implementation, not the surface call 3. Fix the source, not the symptom
+- **Tool sequence**: grep → file_read (implementation) → file_edit → shell_exec (reproduce)
+- **Pitfall**: Do NOT assume the first grep result is the right location. Read at least 2 candidates.
+
+### Same Error Repeating After Fix
+- **Symptom**: Retried same fix 2+ times, error unchanged
+- **Cause**: Mental model of the bug is wrong
+- **Strategy**: 1. Stop retrying 2. Read the full error message again from scratch 3. Search for the exact error string in the codebase 4. Try a structurally different approach
+- **Tool sequence**: grep (exact error string) → file_read → re-analyze
+- **Pitfall**: Do NOT make a third attempt with the same approach. The model of the problem is broken.
+
+### Test Passes But Bug Persists
+- **Symptom**: Test green, but reported behavior still broken
+- **Cause**: Test does not cover the actual failure path
+- **Strategy**: 1. Read the bug report carefully 2. Write a reproduction that exactly matches the reported flow 3. If test passes, the reproduction is wrong — fix the test first
+- **Tool sequence**: file_read (test) → write_file (reproduction) → shell_exec
+- **Pitfall**: Do NOT declare fixed based on passing tests alone. Run the exact reported scenario.
+
+## Validation Checklist
+- [ ] Reproduction script confirms the bug exists before fix
+- [ ] Reproduction script confirms the bug is gone after fix
+- [ ] Full test suite passes (no regressions)
+- [ ] Root cause addressed, not just symptom
+- [ ] No unrelated code changed

package/dist/skills/languages/python.md

@@ -0,0 +1,89 @@
+## Identity
+- domain: python
+- type: language
+- confidence: 0.9
+
+# Python — Common Errors and Patterns
+
+Read the full traceback from bottom to top. The bottom frame is the immediate cause; the top is the entry point.
+
+## Known Error Patterns
+
+### ModuleNotFoundError
+- **Symptom**: `ModuleNotFoundError: No module named 'x'`
+- **Cause**: Package not installed in the active environment, wrong virtual environment active, or a relative import missing the leading dot (`.`).
+- **Strategy**: 1. Run `pip show <package>` to confirm installation. 2. Confirm the correct virtualenv is active (`which python`). 3. If it is a local module, check whether the import should be relative (`.module`) vs. absolute. 4. If the package is missing, install it and add to requirements.txt or pyproject.toml.
+- **Tool sequence**: shell_exec (`pip show package`) → file_read (requirements.txt or pyproject.toml) → shell_exec (`pip install package`) → file_edit (update requirements)
+- **Pitfall**: Do NOT install globally if the project uses a virtualenv. Installing globally can shadow the wrong version and break other projects.
+
+### IndentationError / TabError
+- **Symptom**: `IndentationError: unexpected indent`, `IndentationError: expected an indented block after ...`, or `TabError: inconsistent use of tabs and spaces`
+- **Cause**: Mixed tabs and spaces in the same file, or wrong indent level after a block opener (`def`, `if`, `for`, `class`, `with`, `try`).
+- **Strategy**: 1. Run `python -m py_compile file.py` to get the exact line. 2. Read that line and the line above it. 3. Use `expand` or editor settings to convert all tabs to 4 spaces. 4. Run `black file.py` or `autopep8 --in-place file.py` to auto-fix indentation.
+- **Tool sequence**: shell_exec (`python -m py_compile file.py`) → file_read (reported line) → shell_exec (`black file.py` or `autopep8 --in-place file.py`)
+- **Pitfall**: Do NOT fix indentation by eye in a file with mixed tabs and spaces. Convert all tabs to spaces first, then fix the structure.
+
+### AttributeError: 'NoneType' has no attribute 'x'
+- **Symptom**: `AttributeError: 'NoneType' object has no attribute 'foo'`
+- **Cause**: A variable expected to hold an object is `None`. Typically from a function that returns `None` on failure, an uninitialized field, or a failed ORM query.
+- **Strategy**: 1. Find where the variable is assigned (trace the traceback up). 2. Determine whether `None` is a valid value or an error. 3. If `None` is unexpected, add an assertion or raise early: `if obj is None: raise ValueError(...)`. 4. If `None` is valid, add a guard: `if obj is not None: obj.foo`.
+- **Tool sequence**: file_read (assignment site from traceback) → file_edit (add None check or early raise)
+- **Pitfall**: Do NOT use `getattr(obj, 'foo', None)` to hide the `None` object — that shifts the error downstream. Fix the root cause.
+
+### TypeError — Wrong Number of Arguments
+- **Symptom**: `TypeError: foo() takes X positional arguments but Y were given` or `TypeError: foo() missing Y required positional arguments`
+- **Cause**: Calling a function with wrong argument count. Common: forgetting `self` when calling a method as a function, or passing too many positional args when some should be keyword args.
+- **Strategy**: 1. Grep the function definition to read its signature. 2. Count the parameters. 3. Check if it is a method (requires `self`). 4. Fix the call site to match the signature.
+- **Tool sequence**: grep (function/method name `def`) → file_read → file_edit (fix call site)
+- **Pitfall**: Do NOT add `*args` or `**kwargs` to the function signature to silence the error. Fix the call.
+
+### TypeError — Unsupported Operand Types
+- **Symptom**: `TypeError: unsupported operand type(s) for +: 'int' and 'str'`
+- **Cause**: Mixing incompatible types in an arithmetic or comparison operation. Often from user input (always a string) or mixed data sources.
+- **Strategy**: 1. Read the line in the traceback. 2. Identify which variable has the unexpected type. 3. Add an explicit conversion: `int(x)`, `str(x)`, `float(x)` at the right point. 4. Add a type check if the input source is untrusted.
+- **Tool sequence**: file_read (traceback line) → file_edit (add explicit conversion)
+- **Pitfall**: Do NOT add a bare `try/except` around the operation to hide the error. Convert the type before the operation.
+
+### KeyError on Dictionary Access
+- **Symptom**: `KeyError: 'foo'`
+- **Cause**: Accessing `dict['key']` when the key does not exist.
+- **Strategy**: 1. Use `dict.get('key')` to return `None` when missing, or `dict.get('key', default)` for a default value. 2. If the key must exist, add an assertion or raise with a descriptive message: `if 'key' not in d: raise KeyError(f"Expected key 'key' in {d}")`. 3. If reading from external data, validate the schema before access.
+- **Tool sequence**: file_read (traceback line) → file_edit (replace `dict[key]` with `dict.get(key)` or add guard)
+- **Pitfall**: Do NOT wrap the access in bare `except KeyError: pass`. That hides missing data bugs.
+
+### Circular Import
+- **Symptom**: `ImportError: cannot import name 'X' from partially initialized module 'y'`
+- **Cause**: Module A imports from module B, and module B imports from module A at the top level.
+- **Strategy**: 1. Grep import statements in both modules to confirm the cycle. 2. Move shared types or functions to a third module that neither imports from the other two. 3. Alternatively, use a lazy import (move the import inside the function that needs it). 4. Avoid restructuring via `importlib.import_module` — that just hides the problem.
+- **Tool sequence**: grep (import statements in both modules) → file_read → file_edit (move shared code to third module or use lazy import)
+- **Pitfall**: Do NOT move the import to the bottom of the file as a workaround. That makes the dependency order implicit and fragile.
+
+### RecursionError — Maximum Depth Exceeded
+- **Symptom**: `RecursionError: maximum recursion depth exceeded`
+- **Cause**: A recursive function has no base case, or the base case is never reached for the given input, or two functions call each other indefinitely.
+- **Strategy**: 1. Read the function and identify the base case. 2. Add a print or log to confirm the base case is reachable. 3. If depth is legitimately large, increase with `sys.setrecursionlimit(N)` as a last resort. 4. Convert deep recursion to an iterative loop with an explicit stack.
+- **Tool sequence**: file_read (recursive function) → file_edit (add/fix base case or convert to loop)
+- **Pitfall**: Do NOT just increase the recursion limit without fixing the base case — that defers the crash.
+
+### ValueError from Type Conversion
+- **Symptom**: `ValueError: invalid literal for int() with base 10: 'abc'`
+- **Cause**: Attempting to convert a string that does not represent the target type.
+- **Strategy**: 1. Validate the input before conversion. 2. Wrap in a try/except and handle the ValueError specifically. 3. For user-facing input, return an error message rather than crashing.
+- **Tool sequence**: file_read (conversion site) → file_edit (add try/except ValueError or pre-validation)
+- **Pitfall**: Do NOT use a bare `except:` or `except Exception:`. Catch `ValueError` specifically.
+
+## Verification
+- Syntax: `python -m py_compile file.py` — exit 0 means no syntax errors.
+- Tests: `pytest` or `python -m pytest` — all tests must pass.
+- Type check (if project uses mypy): `mypy .` — zero errors.
+- Linting: `flake8 .` or `ruff check .`
+
+## Validation Checklist
+- [ ] `python -m py_compile` exits 0 on all modified files
+- [ ] All imports resolve in the active virtual environment
+- [ ] No mixed tabs and spaces (run `black` or `autopep8`)
+- [ ] All None-returning function calls guarded before attribute access
+- [ ] All dict accesses use `.get()` or have key existence check
+- [ ] Recursive functions have a reachable base case
+- [ ] Tests pass with `pytest`
+- [ ] mypy exits 0 if the project has a mypy configuration

package/dist/skills/languages/react.md

@@ -0,0 +1,86 @@
+## Identity
+- domain: react
+- type: language
+- confidence: 0.9
+
+# React — Hook Rules, Rendering, and Common Errors
+
+Read the full error message and component stack before touching any code.
+
+## Hook Rules (Enforced by eslint-plugin-react-hooks)
+- Call hooks only at the top level of a function component — never inside conditions, loops, or nested functions.
+- Call hooks only from React function components or other custom hooks.
+- Custom hooks must start with `use`.
+- These rules are not style preferences — violating them causes non-deterministic behavior and crashes that are hard to reproduce.
+
+## Known Error Patterns
+
+### Hook Called Conditionally
+- **Symptom**: ESLint error `React Hook "useX" is called conditionally` — or a runtime crash: `Rendered more hooks than during the previous render`
+- **Cause**: Hook call placed inside an `if` block, after an early `return`, or inside a loop. React requires the same hooks to run in the same order on every render.
+- **Strategy**: Move all hook calls to the top of the component function, above any conditional logic. If the hook should only do something conditionally, move the condition inside the hook's callback or pass a flag to the hook.
+- **Tool sequence**: file_read (component) → file_edit (move hook calls above all conditionals)
+- **Pitfall**: Do NOT wrap hook calls in try/catch or ternary expressions. Restructure the component so all hooks run unconditionally.
+
+### Stale Closure in useEffect
+- **Symptom**: Effect reads an old value of state or props. The callback always has the value from the first render regardless of updates.
+- **Cause**: The dependency array is incomplete — it is missing variables that are read inside the effect.
+- **Strategy**: Add every variable read inside the effect body to the dependency array. If adding a function reference creates an infinite loop, wrap the function in `useCallback` with its own deps. If adding an object creates an infinite loop, use `useMemo` or restructure to pass only primitive values.
+- **Tool sequence**: file_read (useEffect block and deps array) → file_edit (add missing deps)
+- **Pitfall**: Do NOT add `// eslint-disable-next-line react-hooks/exhaustive-deps` to suppress the exhaustive-deps warning. Fix the missing dependencies.
+
+### Infinite Re-render Loop
+- **Symptom**: Component re-renders continuously; browser tab becomes unresponsive or crashes.
+- **Cause**: One of: (a) `setState` called unconditionally inside `useEffect` with no deps or with deps that always change, (b) an object or array literal created inline is in the dependency array (new reference every render), (c) parent passes a new object/function prop on every render.
+- **Strategy**: 1. Read every `useEffect` in the component. Find any `setState` call without a guard condition. 2. Check the deps array for inline object/array literals — move them outside the component or wrap in `useMemo`/`useCallback`. 3. If the loop comes from a parent prop, memoize the prop at the parent.
+- **Tool sequence**: file_read (all useEffect blocks) → file_edit (add condition or memoize deps)
+- **Pitfall**: Do NOT add an empty dependency array `[]` to stop the loop without understanding why it loops. That causes stale closure bugs.
+
+### Hydration Mismatch (Next.js / SSR)
+- **Symptom**: `Error: Text content does not match server-rendered HTML` or `Error: Hydration failed because the initial UI does not match what was rendered on the server`
+- **Cause**: Component renders different content on server vs. client. Common sources: `Date.now()`, `Math.random()`, `window` access, browser-only APIs, locale-dependent formatting.
+- **Strategy**: 1. Identify the value that differs between server and client renders. 2. Move it into a `useEffect` with a local state variable — `useEffect` only runs on the client. 3. Render a placeholder or `null` on first render, then update after mount. 4. Use `suppressHydrationWarning` only on elements with genuinely intentional dynamic content such as timestamps.
+- **Tool sequence**: file_read (component) → file_edit (move dynamic value to useEffect + useState)
+- **Pitfall**: Do NOT use `suppressHydrationWarning` as a general fix. It hides real bugs where content genuinely differs.
+
+### Missing key Prop in List
+- **Symptom**: React warning `Each child in a list should have a unique "key" prop`
+- **Cause**: `Array.map()` renders JSX elements without a `key` prop, or key is not unique within the list.
+- **Strategy**: Add a stable, unique `key` to each element. Use the item's ID from data, not the array index.
+- **Tool sequence**: grep (`\.map(`) → file_read (render section) → file_edit (add key prop)
+- **Pitfall**: Do NOT use array index as key when the list can reorder, filter, or have items added or removed. Index keys cause incorrect reconciliation and state bugs.
+
+### Cannot Read Property of Undefined (During Render)
+- **Symptom**: `TypeError: Cannot read properties of undefined (reading 'x')` thrown during render
+- **Cause**: Component accesses a property on a value that is `undefined` or `null` at mount time — typically async data, optional props, or uninitialized store state.
+- **Strategy**: 1. Add a loading/null guard before the access: `if (!data) return null` or `data?.property`. 2. Provide a default value in the prop type or initial state. 3. Never assume async data is available at first render.
+- **Tool sequence**: file_read (render return and prop types) → file_edit (add guard)
+- **Pitfall**: Do NOT add `!` non-null assertion in TypeScript to hide this — the crash will still happen at runtime.
+
+### Context Value Lost After Rerender
+- **Symptom**: Component reads default context value instead of the provided value; context updates do not propagate.
+- **Cause**: Provider is placed too low in the tree, or `value` prop creates a new object every render causing unnecessary re-renders and sometimes missed updates.
+- **Strategy**: 1. Confirm the consuming component is inside the Provider in the tree. 2. Memoize the context value with `useMemo` to prevent new object reference on every render. 3. Split contexts if one high-frequency value is causing all consumers to re-render.
+- **Tool sequence**: file_read (Provider placement) → file_read (consumer component) → file_edit (add useMemo to context value)
+- **Pitfall**: Do NOT create the context value inline in the JSX without memoization — `value={{ foo, bar }}` creates a new object on every render.
+
+### useRef Value Not Triggering Re-render
+- **Symptom**: Component does not update when a `ref.current` value changes.
+- **Cause**: `useRef` mutations do not trigger re-renders — this is by design.
+- **Strategy**: If you need UI to update when a value changes, use `useState` or `useReducer` instead. Use `useRef` only for values that should NOT trigger re-renders: DOM references, timers, previous value tracking, and imperative handles.
+- **Tool sequence**: file_read (ref usage) → file_edit (convert to useState if re-render is needed)
+- **Pitfall**: Do NOT try to force a re-render after mutating a ref. Switch to state.
+
+## Verification
+- ESLint: `eslint --ext .tsx,.ts src/` — look for `react-hooks/rules-of-hooks` and `react-hooks/exhaustive-deps` violations.
+- Type check: `tsc --noEmit`
+- Dev server: confirm no console errors beginning with `Warning: ` or `Error: ` in the browser.
+
+## Validation Checklist
+- [ ] All hooks called unconditionally at component top level, before any early returns
+- [ ] useEffect dependency arrays include all referenced variables (no exhaustive-deps suppressions)
+- [ ] No inline object or array literals in dependency arrays
+- [ ] All list renders have stable unique keys from data (not array index)
+- [ ] Browser-only code wrapped in useEffect or guarded with `typeof window !== "undefined"`
+- [ ] Context values memoized with useMemo if they are object or array literals
+- [ ] Async data access guarded with null/undefined check at render time