@acmecloud/core 1.0.5 → 1.0.7

package/src/skills/builtin/windows-shell-guide.md

@@ -0,0 +1,119 @@
+---
+name: windows-shell-guide
+description: Windows PowerShell command reference - use on Windows instead of Unix commands
+---
+
+# Windows Shell Guide
+
+**Use when OS is Windows (win32)**
+
+## Forbidden Commands on Windows
+
+**DO NOT use:**
+`head`, `tail`, `grep`, `sed`, `awk`, `xargs`, `wc`, `ls`, `cp`, `mv`, `rm`, `ps`, `kill`, `chmod`, `chown`
+
+## Quick Reference
+
+| Need           | PowerShell Command                   |
+| -------------- | ------------------------------------ |
+| View file      | `Get-Content file`                   |
+| First N lines  | `Get-Content file -Head N`           |
+| Last N lines   | `Get-Content file -Tail N`           |
+| Search text    | `Select-String "pattern" file`       |
+| Count lines    | `(Get-Content file).Count`           |
+| List files     | `Get-ChildItem`                      |
+| Copy file      | `Copy-Item src dest`                 |
+| Move file      | `Move-Item src dest`                 |
+| Delete file    | `Remove-Item file -Force`            |
+| Delete folder  | `Remove-Item folder -Recurse -Force` |
+| List processes | `Get-Process`                        |
+| Kill process   | `Stop-Process -Id PID -Force`        |
+
+## Common Patterns
+
+### File Operations
+
+```powershell
+# Read file
+Get-Content file.txt
+
+# Search in file
+Select-String "error" file.txt
+
+# Count lines
+(Get-Content file.txt).Count
+
+# Find files
+Get-ChildItem -Filter "*.py" -Recurse
+
+# Delete with force
+Remove-Item file.txt -Force
+Remove-Item folder -Recurse -Force
+```
+
+### Process Management
+
+```powershell
+# List processes
+Get-Process python
+
+# Kill process
+Stop-Process -Id 1234 -Force
+
+# Filter processes
+Get-Process | Where-Object {$_.Name -like "python"}
+```
+
+### Pipes and Filtering
+
+```powershell
+# Find files > 1MB
+Get-ChildItem -Recurse | Where-Object {$_.Length -gt 1MB}
+
+# Search in multiple files
+Get-ChildItem -Filter "*.log" | Select-String "ERROR"
+
+# Get top 5 by CPU
+Get-Process | Sort-Object CPU -Descending | Select-Object -First 5
+```
+
+## Common Mistakes
+
+| Unix (DON'T)        | PowerShell (DO)                      |
+| ------------------- | ------------------------------------ |
+| `head file.txt`     | `Get-Content file.txt -Head 10`      |
+| `grep "pattern"`    | `Select-String "pattern"`            |
+| `cat file \| wc -l` | `(Get-Content file).Count`           |
+| `rm -rf folder`     | `Remove-Item folder -Recurse -Force` |
+| `ls -la`            | `Get-ChildItem`                      |
+
+## Safe Execution
+
+```powershell
+# Dry run (preview changes)
+Get-ChildItem folder -Recurse -WhatIf
+
+# Check before delete
+if (Test-Path file.txt) { Remove-Item file.txt }
+
+# Suppress errors
+Get-Content file.txt -ErrorAction SilentlyContinue
+```
+
+## Common Parameters
+
+- `-WhatIf` - Preview changes
+- `-Confirm` - Prompt before execution
+- `-ErrorAction` - Stop, SilentlyContinue, Continue
+- `-Verbose` - Detailed output
+- `-Recurse` - Include subdirectories
+- `-Force` - Override restrictions
+
+## Key Principles
+
+1. Always check OS first
+2. Use PowerShell Verb-Noun syntax
+3. Reference this guide before guessing
+4. Test dangerous operations with `-WhatIf`
+
+**Stop errors before they happen:** Check OS, read guide, execute correctly.

package/src/skills/index.ts

@@ -1,86 +1,141 @@
-import * as fs from 'fs/promises';
-import path from 'path';
-import os from 'os';
-
-export interface Skill {
-    name: string;
-    description: string;
-    content: string;
-}
-
-/**
- * Searches upward from startDir for the given targets.
- */
-async function findUpDirectories(startDir: string, targets: string[]): Promise<string[]> {
-    const results: string[] = [];
-    let current = path.resolve(startDir);
-    const root = path.parse(current).root;
-
-    while (true) {
-        for (const target of targets) {
-            const fullPath = path.join(current, target);
-            try {
-                const stat = await fs.stat(fullPath);
-                if (stat.isDirectory()) {
-                    results.push(fullPath);
-                }
-            } catch {
-                // Ignore
-            }
-        }
-        if (current === root) break;
-        current = path.dirname(current);
-    }
-    return results;
-}
-
-export async function loadSkills(): Promise<Skill[]> {
-    const globalSkillsPath = path.join(os.homedir(), '.acmecode', 'skills');
-
-    // OpenCode patterns: .agents/skills, .claude/skills, .acmecode/skills
-    const searchTargets = [
-        '.acmecode/skills',
-        '.agents/skills',
-        '.claude/skills',
-    ];
-
-    const localSkillDirs = await findUpDirectories(process.cwd(), searchTargets);
-
-    // Priority: Lower directories in the tree (closer to project root) are processed first,
-    // and higher directories (closer to CWD) are processed last to overwrite.
-    // Global is processed first of all.
-    const allDirs = [globalSkillsPath, ...localSkillDirs.reverse()];
-    const skillsMap = new Map<string, Skill>();
-
-    for (const dir of allDirs) {
-        try {
-            const files = await fs.readdir(dir);
-            for (const file of files) {
-                if (file.endsWith('.md')) {
-                    const content = await fs.readFile(path.join(dir, file), 'utf8');
-                    let name = file.replace('.md', '');
-
-                    // Improved parsing: Look for name and description in YAML frontmatter or content
-                    let description = `Skill ${name}`;
-
-                    // Try to extract name from frontmatter
-                    const nameMatch = content.match(/^name:\s*(.*)/m);
-                    if (nameMatch) name = nameMatch[1].trim();
-
-                    const descriptionMatch = content.match(/^description:\s*(.*)/m);
-                    if (descriptionMatch) {
-                        description = descriptionMatch[1].trim();
-                    }
-
-                    skillsMap.set(name, { name, description, content });
-                }
-            }
-        } catch (err: any) {
-            if (err.code !== 'ENOENT') {
-                console.warn(`Could not read skills directory ${dir}: ${err.message}`);
-            }
-        }
-    }
-
-    return Array.from(skillsMap.values());
-}
+import * as fs from "fs/promises";
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export interface Skill {
+  name: string;
+  description: string;
+  content: string;
+}
+
+/**
+ * Load built-in skills from the builtin directory
+ */
+async function loadBuiltinSkills(): Promise<Skill[]> {
+  const builtinSkillsDir = path.join(__dirname, "builtin");
+  const skills: Skill[] = [];
+
+  try {
+    const files = await fs.readdir(builtinSkillsDir);
+    for (const file of files) {
+      if (file.endsWith(".md")) {
+        const filePath = path.join(builtinSkillsDir, file);
+        const content = await fs.readFile(filePath, "utf8");
+        let name = file.replace(".md", "");
+        let description = `Skill ${name}`;
+
+        // Extract name from frontmatter
+        const nameMatch = content.match(/^---[\r\n]+name:\s*(.*)/m);
+        if (nameMatch) {
+          name = nameMatch[1].trim();
+        }
+
+        // Extract description from frontmatter
+        const descriptionMatch = content.match(/^description:\s*(.*)/m);
+        if (descriptionMatch) {
+          description = descriptionMatch[1].trim();
+        }
+
+        skills.push({ name, description, content });
+      }
+    }
+  } catch (err: any) {
+    if (err.code !== "ENOENT") {
+      console.warn(`Could not read builtin skills: ${err.message}`);
+    }
+  }
+
+  return skills;
+}
+
+/**
+ * Searches upward from startDir for the given targets.
+ */
+async function findUpDirectories(
+  startDir: string,
+  targets: string[],
+): Promise<string[]> {
+  const results: string[] = [];
+  let current = path.resolve(startDir);
+  const root = path.parse(current).root;
+
+  while (true) {
+    for (const target of targets) {
+      const fullPath = path.join(current, target);
+      try {
+        const stat = await fs.stat(fullPath);
+        if (stat.isDirectory()) {
+          results.push(fullPath);
+        }
+      } catch {
+        // Ignore
+      }
+    }
+    if (current === root) break;
+    current = path.dirname(current);
+  }
+  return results;
+}
+
+export async function loadSkills(): Promise<Skill[]> {
+  const globalSkillsPath = path.join(os.homedir(), ".acmecode", "skills");
+
+  // OpenCode patterns: .agents/skills, .claude/skills, .acmecode/skills
+  const searchTargets = [
+    ".acmecode/skills",
+    ".agents/skills",
+    ".claude/skills",
+  ];
+
+  const localSkillDirs = await findUpDirectories(process.cwd(), searchTargets);
+
+  // Priority: Lower directories in the tree (closer to project root) are processed first,
+  // and higher directories (closer to CWD) are processed last to overwrite.
+  // Global is processed first of all.
+  const allDirs = [globalSkillsPath, ...localSkillDirs.reverse()];
+  const skillsMap = new Map<string, Skill>();
+
+  // First, load built-in skills
+  const builtinSkills = await loadBuiltinSkills();
+  for (const skill of builtinSkills) {
+    skillsMap.set(skill.name, skill);
+  }
+
+  // Then load user skills (can override built-ins)
+  for (const dir of allDirs) {
+    try {
+      const files = await fs.readdir(dir);
+      for (const file of files) {
+        if (file.endsWith(".md")) {
+          const content = await fs.readFile(path.join(dir, file), "utf8");
+          let name = file.replace(".md", "");
+
+          // Improved parsing: Look for name and description in YAML frontmatter or content
+          let description = `Skill ${name}`;
+
+          // Try to extract name from frontmatter
+          const nameMatch = content.match(/^name:\s*(.*)/m);
+          if (nameMatch) name = nameMatch[1].trim();
+
+          const descriptionMatch = content.match(/^description:\s*(.*)/m);
+          if (descriptionMatch) {
+            description = descriptionMatch[1].trim();
+          }
+
+          skillsMap.set(name, { name, description, content });
+        }
+      }
+    } catch (err: any) {
+      if (err.code !== "ENOENT") {
+        console.warn(`Could not read skills directory ${dir}: ${err.message}`);
+      }
+    }
+  }
+
+  return Array.from(skillsMap.values());
+}