@yuaone/core 0.8.5 → 0.9.1

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/bash.md

@@ -0,0 +1,74 @@
+## Identity
+- domain: bash
+- type: language
+- confidence: 0.90
+
+# Bash/Shell — Error Pattern Reference
+
+Always start scripts with `#!/usr/bin/env bash` and `set -euo pipefail`. Most Bash bugs are invisible without these settings. Use `shellcheck` for static analysis.
+
+## Quick Reference
+- **exit code 127** — Command not found.
+- **exit code 126** — Command found but not executable (permission issue).
+- **exit code 1** — General error; check the command's stderr.
+- **unbound variable** — `set -u` is active and an unset variable was used.
+- **broken pipe** — Consumer of a pipeline exited before producer finished.
+
+## Known Error Patterns
+
+### Unbound Variable (set -u)
+- **Symptom**: `bash: FOO: unbound variable` — script exits immediately.
+- **Cause**: `set -u` (nounset) is active and a variable is referenced before being assigned. Common with optional variables, unset environment variables, or array out-of-bounds access.
+- **Strategy**: 1. Identify the variable. 2. Provide a default: `${FOO:-default_value}`. Use `${FOO:-}` (empty default) if an empty string is acceptable. 3. For required variables, add an explicit check before use: `if [[ -z "${FOO:-}" ]]; then echo "FOO is required" >&2; exit 1; fi`.
+- **Tool sequence**: file_read (script lines around error) → file_edit (add `${VAR:-default}` or explicit check)
+- **Pitfall**: Do NOT remove `set -u` to silence the error. The unbound variable is the real bug.
+
+### Word Splitting on Unquoted Variable
+- **Symptom**: Script fails or behaves wrong when a variable contains spaces or glob characters. A filename like `my file.txt` becomes two arguments.
+- **Cause**: Unquoted variable expansion in Bash: `$var` undergoes word splitting and pathname expansion. `"$var"` does not.
+- **Strategy**: 1. Quote all variable expansions: `"$var"`, `"$@"`, `"${array[@]}"`. 2. Run `shellcheck <script>` — it flags all unquoted variables. 3. For arrays, always use `"${arr[@]}"` not `${arr[*]}`.
+- **Tool sequence**: shell_exec (`shellcheck <script>`) → file_read (flagged lines) → file_edit (add quotes)
+- **Pitfall**: Do NOT use single quotes `'$var'` — that prevents expansion entirely. Use double quotes `"$var"`.
+
+### Missing pipefail (set -eo pipefail)
+- **Symptom**: Script reports success even when a command in a pipeline fails. E.g., `false | tee output.txt` exits 0 without `pipefail`.
+- **Cause**: Without `set -o pipefail`, a pipeline's exit code is only the last command's exit code. Failures in earlier pipeline stages are silently ignored.
+- **Strategy**: 1. Add `set -euo pipefail` at the top of every script (after the shebang). 2. For individual pipelines where partial failure is expected, use `set +o pipefail` around that block and restore it after.
+- **Tool sequence**: file_read (top of script) → file_edit (add `set -euo pipefail` after shebang)
+- **Pitfall**: `set -e` alone is not enough for pipelines. Always pair it with `set -o pipefail`.
+
+### Command Not Found in PATH
+- **Symptom**: `command not found: foo` — exit code 127.
+- **Cause**: The command is not in any directory listed in `$PATH`. Common when running scripts as a different user (cron, sudo), in Docker containers with minimal PATH, or when a tool is installed in a non-standard location.
+- **Strategy**: 1. Run `which foo` or `type foo` to verify presence in the current shell. 2. For cron and CI, always use absolute paths: `/usr/bin/foo` or `/usr/local/bin/foo`. 3. If the tool is optional, check before use: `if ! command -v foo &>/dev/null; then echo "foo not installed" >&2; exit 1; fi`. 4. Source the correct profile/environment if the tool is installed via a version manager (nvm, rbenv, pyenv).
+- **Tool sequence**: shell_exec (`which foo`) → shell_exec (`echo $PATH`) → file_edit (use absolute path or add PATH setup)
+- **Pitfall**: Do NOT hardcode `/usr/bin/foo` if the tool may be in `/usr/local/bin` on some systems. Use `command -v` to find it dynamically when portability matters.
+
+### Wrong or Missing Shebang
+- **Symptom**: Script runs with the wrong interpreter (e.g., `sh` instead of `bash`), causing `[[`, arrays, or `local` to fail with syntax errors. Or: permission denied / bad interpreter.
+- **Cause**: Shebang (`#!`) is missing, wrong (`#!/bin/sh` when bashisms are used), or the path is wrong for the target system.
+- **Strategy**: 1. Use `#!/usr/bin/env bash` for portability — `env` finds bash in PATH. 2. Use `#!/bin/sh` only if the script is strictly POSIX sh. 3. If using `[[`, arrays, `local`, `$((...))`, `declare`, or `source`, the shebang must be `bash`. 4. Ensure the file has execute permission: `chmod +x script.sh`.
+- **Tool sequence**: file_read (first line of script) → file_edit (fix shebang) → shell_exec (`chmod +x`)
+- **Pitfall**: On some systems (Alpine Linux, minimal Docker), `/bin/bash` does not exist. Use `#!/usr/bin/env bash` instead.
+
+### Arithmetic — Unintended Glob Expansion
+- **Symptom**: Script exits unexpectedly, or `*` in an expression matches files instead of meaning multiplication.
+- **Cause**: In `[[ ]]` or `$(( ))`, operators like `*`, `?`, `[` have special meanings. Outside these contexts they trigger pathname expansion.
+- **Strategy**: 1. Always use `$(( expr ))` for arithmetic, never `expr` or `let` in new scripts. 2. Quote file patterns that should be treated as literals. 3. Use `[[ ]]` instead of `[ ]` for conditionals — `[[ ]]` does not perform pathname or word splitting.
+- **Tool sequence**: file_read (expression line) → file_edit (replace `[ ]` with `[[ ]]`, wrap arithmetic in `$(( ))`)
+- **Pitfall**: `(( ))` arithmetic returns exit code 1 when the result is 0, which triggers `set -e`. Use `(( expr )) || true` or wrap in an `if`.
+
+## Verification
+Run: `shellcheck <script>` — address all SC#### warnings before deployment.
+- For syntax check only: `bash -n <script>`.
+- Test with edge-case inputs: empty strings, paths with spaces, special characters.
+
+## Validation Checklist
+- [ ] `#!/usr/bin/env bash` on first line
+- [ ] `set -euo pipefail` on second line
+- [ ] `shellcheck` reports zero warnings
+- [ ] All variable expansions quoted: `"$var"`, `"${arr[@]}"`
+- [ ] All external commands referenced by absolute path in cron/CI contexts
+- [ ] `command -v` used to check optional tools before use
+- [ ] No `[ ]` — replaced with `[[ ]]` for conditionals
+- [ ] Arithmetic done in `$(( ))` not with `expr`

package/dist/skills/languages/c.md

@@ -0,0 +1,76 @@
+## Identity
+- domain: c
+- type: language
+- confidence: 0.93
+
+# C — Error Pattern Reference
+
+Compile with warnings enabled: `-Wall -Wextra -Werror`. Many C bugs are silent at compile time but fatal at runtime. Always use a sanitizer (`-fsanitize=address,undefined`) during development.
+
+## Compiler Warning Quick Reference
+- **-Wimplicit-function-declaration** — Calling a function without a prototype.
+- **-Wuninitialized** — Variable used before assignment.
+- **-Wformat** — printf/scanf format string mismatch.
+- **-Wreturn-type** — Missing return in non-void function.
+- **-Warray-bounds** — Array index out of declared bounds (static analysis only).
+- **-Wconversion** — Implicit narrowing conversion.
+- **-Wnull-dereference** — Pointer that may be NULL is dereferenced.
+
+## Known Error Patterns
+
+### Segmentation Fault — Null Pointer Dereference
+- **Symptom**: Program crashes with `Segmentation fault (core dumped)`. GDB shows crash at a pointer dereference.
+- **Cause**: Dereferencing a pointer that is NULL, uninitialized, or has been freed. Common after `malloc` failure (returns NULL), a function returning NULL on error, or using a pointer before assignment.
+- **Strategy**: 1. Run under GDB: `gdb ./program core` then `bt` for backtrace. 2. Identify the faulting line. 3. Add a NULL check before every pointer dereference. 4. For `malloc`: always check `if (ptr == NULL) { /* handle */ }` immediately after allocation. 5. Run with AddressSanitizer: `gcc -fsanitize=address -g` for detailed diagnostics.
+- **Tool sequence**: shell_exec (`gcc -g -fsanitize=address`) → shell_exec (run program) → file_read (faulting line) → file_edit (add NULL check)
+- **Pitfall**: Do NOT assume `malloc` always succeeds. Check the return value every time.
+
+### Buffer Overflow — strcpy / gets / sprintf
+- **Symptom**: Program writes garbage data, crashes unpredictably, or behaves differently between debug and release builds. ASan reports `heap-buffer-overflow` or `stack-buffer-overflow`.
+- **Cause**: `strcpy`, `gets`, `sprintf`, or manual loop writes beyond the allocated buffer. `gets` has no length argument and is inherently unsafe.
+- **Strategy**: 1. Replace `gets` with `fgets(buf, sizeof(buf), stdin)`. 2. Replace `strcpy(dst, src)` with `strncpy(dst, src, sizeof(dst) - 1); dst[sizeof(dst)-1] = '\0';` or use `strlcpy` if available. 3. Replace `sprintf` with `snprintf(buf, sizeof(buf), fmt, ...)`. 4. Audit every buffer write in the file for bound checks.
+- **Tool sequence**: grep (`strcpy\|gets\|sprintf`) → file_read → file_edit (replace with safe variants)
+- **Pitfall**: `strncpy` does NOT null-terminate if the source is longer than n. Always manually set `dst[n-1] = '\0'`.
+
+### Memory Leak — malloc Without free
+- **Symptom**: Program memory usage grows unboundedly. Valgrind reports `definitely lost` or `indirectly lost` blocks.
+- **Cause**: Memory allocated with `malloc`/`calloc`/`realloc` is not freed on all code paths, especially error paths.
+- **Strategy**: 1. Run with Valgrind: `valgrind --leak-check=full ./program`. 2. For each allocation, trace all code paths and confirm `free` is called. 3. Use a consistent pattern: allocate near the start of a scope, free at the end via a cleanup label (`goto cleanup`). 4. Ensure error paths also reach the cleanup label.
+- **Tool sequence**: shell_exec (`valgrind --leak-check=full`) → grep (`malloc\|calloc`) → file_read (all exit paths) → file_edit (add free on all paths)
+- **Pitfall**: Do NOT free a pointer and then use it. Set it to NULL after freeing: `free(p); p = NULL;`.
+
+### Undefined Behavior — Signed Integer Overflow
+- **Symptom**: Unexpected values or crashes only in optimized builds (`-O2`). UBSan reports `signed integer overflow`.
+- **Cause**: Signed integer overflow is undefined behavior in C. Compilers exploit this for optimization, leading to code elimination or wrong values. Common in loop counters, hash functions, and arithmetic.
+- **Strategy**: 1. Compile with `-fsanitize=undefined` to detect overflows. 2. For arithmetic that may overflow, use unsigned types or check before the operation: `if (a > INT_MAX - b) { /* overflow */ }`. 3. Do NOT rely on signed wrap-around behavior.
+- **Tool sequence**: shell_exec (`gcc -fsanitize=undefined -g`) → file_read (arithmetic code) → file_edit (add overflow check or use unsigned)
+- **Pitfall**: Do NOT use `(int)(a + b)` cast to suppress the warning. The overflow happens before the cast.
+
+### Implicit Function Declaration
+- **Symptom**: Compiler warning: `implicit declaration of function 'foo'`; in C99 and later this is an error.
+- **Cause**: Calling a function before its prototype is declared. Missing `#include` for a library function, or a function defined later in the file without a forward declaration.
+- **Strategy**: 1. For standard library functions, identify and add the correct `#include`. 2. For project-internal functions, add a forward declaration at the top of the file or move the definition above the call site. 3. Always compile with `-Wimplicit-function-declaration -Werror`.
+- **Tool sequence**: grep (`#include`) → file_read (function call line) → shell_exec (`man <function>` for required header) → file_edit (add include or forward declaration)
+- **Pitfall**: Do NOT add an implicit `int` return type declaration manually — add the full correct prototype.
+
+### Use of Uninitialized Variable
+- **Symptom**: Garbage values read, random behavior, or UBSan reports `use of uninitialized value`.
+- **Cause**: Local variable declared but not assigned before first read. Conditional initialization that misses a code path.
+- **Strategy**: 1. Compile with `-Wuninitialized`. 2. Initialize all local variables at declaration: `int count = 0;`, `char *p = NULL;`. 3. For structs, use `= {0}` to zero-initialize: `struct Foo f = {0};`.
+- **Tool sequence**: shell_exec (`gcc -Wall -Wuninitialized`) → file_read (variable declaration) → file_edit (add initializer)
+- **Pitfall**: Do NOT rely on global/static variables being zero-initialized to justify skipping local initialization. Be explicit.
+
+## Verification
+Compile command: `gcc -Wall -Wextra -Werror -g -fsanitize=address,undefined -o program main.c`
+- Fix all warnings before proceeding — `-Werror` enforces this.
+- Run Valgrind for memory checks in CI: `valgrind --error-exitcode=1 ./program`
+
+## Validation Checklist
+- [ ] `gcc -Wall -Wextra -Werror` produces zero warnings
+- [ ] Every `malloc`/`calloc`/`realloc` return value checked for NULL
+- [ ] Every `free` followed by setting pointer to NULL
+- [ ] No `gets`, `strcpy`, or unbounded `sprintf` in codebase
+- [ ] All local variables initialized at declaration
+- [ ] No signed integer arithmetic that can overflow without a guard
+- [ ] All functions declared before first use (via include or forward declaration)
+- [ ] Tested with `-fsanitize=address,undefined` during development