cdsa-harness 0.1.1 → 0.4.0

package/src/skills.js

@@ -0,0 +1,61 @@
+// 스킬 시스템 — OpenCode 의 커스텀 커맨드와 같은 개념.
+// `.cdsa/skills/` (작업 폴더) 와 `~/.cdsa_harness/skills/` (전역) 의 .md 파일을 불러온다.
+// 파일명이 곧 스킬 이름이고(`/이름` 으로 실행), 본문은 모델에 전달할 프롬프트 템플릿이다.
+// 본문 안의 `$ARGUMENTS` 는 `/이름 뒤에 붙인 텍스트` 로 치환된다.
+//
+//   ---
+//   description: 파일을 읽고 3줄로 요약
+//   ---
+//   $ARGUMENTS 파일을 read_file 로 읽고 핵심을 한국어 3줄로 요약해줘.
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+export function skillDirs(workspace) {
+  return [
+    path.join(os.homedir(), ".cdsa_harness", "skills"),
+    path.join(workspace, ".cdsa", "skills"),
+  ];
+}
+
+function parseFrontmatter(text) {
+  const m = /^---\n([\s\S]*?)\n---\n?/.exec(text);
+  if (!m) return { meta: {}, body: text.trim() };
+  const meta = {};
+  for (const line of m[1].split("\n")) {
+    const i = line.indexOf(":");
+    if (i > 0) meta[line.slice(0, i).trim()] = line.slice(i + 1).trim();
+  }
+  return { meta, body: text.slice(m[0].length).trim() };
+}
+
+export function loadSkills(workspace) {
+  const skills = {};
+  for (const dir of skillDirs(workspace)) {
+    let files = [];
+    try {
+      if (!fs.existsSync(dir)) continue;
+      files = fs.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
+    } catch {
+      continue;
+    }
+    for (const f of files) {
+      const name = f.replace(/\.md$/, "");
+      try {
+        const raw = fs.readFileSync(path.join(dir, f), "utf8");
+        const { meta, body } = parseFrontmatter(raw);
+        skills[name] = { name, description: meta.description || "", body, source: path.join(dir, f) };
+      } catch {
+        /* ignore unreadable skill */
+      }
+    }
+  }
+  return skills;
+}
+
+// 스킬 본문에 인자를 채워 최종 프롬프트를 만든다.
+export function renderSkill(skill, args) {
+  const argStr = (args || "").trim();
+  if (skill.body.includes("$ARGUMENTS")) return skill.body.replace(/\$ARGUMENTS/g, argStr);
+  return argStr ? `${skill.body}\n\n[추가 입력]\n${argStr}` : skill.body;
+}

package/src/tools.js

@@ -51,10 +51,27 @@ export function diffLines(oldText, newText) {
 }
 
 export class Toolbox {
-  constructor(workspace, allowShell = false) {
+  constructor(workspace, allowShell = false, plugins = []) {
     this.workspace = path.resolve(workspace);
     fs.mkdirSync(this.workspace, { recursive: true });
     this.allowShell = allowShell;
+    // 정상 로드된 플러그인만 도구로 사용(로드 에러는 따로 보관해 표시).
+    this.plugins = plugins.filter((p) => p && p.name && typeof p.handler === "function");
+    this.pluginErrors = plugins.filter((p) => p && p.error).map((p) => p.error);
+    this._pluginMap = new Map(this.plugins.map((p) => [p.name, p]));
+  }
+
+  // 실행 전 사용자 승인이 필요한 도구인가? (환경을 바꾸는 내장 도구 + mutating 플러그인)
+  isMutating(name) {
+    if (MUTATING_TOOLS.has(name)) return true;
+    const p = this._pluginMap.get(name);
+    return Boolean(p && p.mutating);
+  }
+
+  label(name) {
+    if (TOOL_LABELS[name]) return TOOL_LABELS[name];
+    const p = this._pluginMap.get(name);
+    return p ? `플러그인:${name}` : name;
   }
 
   _resolve(rel) {
@@ -148,16 +165,27 @@ export class Toolbox {
     return { ok: code === 0, output: `$ ${command}\n(exit=${code})\n${out}` };
   }
 
-  execute(name, args = {}) {
+  async execute(name, args = {}) {
     if (name === "list_dir") return this.listDir(args.path || ".");
     if (name === "read_file") return this.readFile(args.path || "");
     if (name === "write_file") return this.writeFile(args.path || "", args.content || "");
     if (name === "run_shell") return this.runShell(args.command || "");
+    const plugin = this._pluginMap.get(name);
+    if (plugin) {
+      let result;
+      try {
+        result = await plugin.handler(args, { workspace: this.workspace });
+      } catch (e) {
+        throw new ToolError(`플러그인 '${name}' 실행 오류: ${e.message}`);
+      }
+      const output = typeof result === "string" ? result : result?.output ?? JSON.stringify(result);
+      return { ok: true, output: String(output) };
+    }
     throw new ToolError(`알 수 없는 도구입니다: ${name}`);
   }
 }
 
-export function toolSchemas(allowShell = false) {
+export function toolSchemas(allowShell = false, plugins = []) {
   const schemas = [
     {
       type: "function",
@@ -216,5 +244,17 @@ export function toolSchemas(allowShell = false) {
       },
     });
   }
+  // 플러그인이 제공하는 도구를 모델에게도 노출한다.
+  for (const p of plugins) {
+    if (!p || !p.name || typeof p.handler !== "function") continue;
+    schemas.push({
+      type: "function",
+      function: {
+        name: p.name,
+        description: (p.description || `플러그인 도구 ${p.name}`) + (p.mutating ? " (승인 필요)" : ""),
+        parameters: p.parameters || { type: "object", properties: {} },
+      },
+    });
+  }
   return schemas;
 }

package/workspace/.cdsa/plugins/word_count.mjs

@@ -0,0 +1,31 @@
+// 예시 플러그인: 작업 폴더 안 텍스트 파일의 글자/줄/단어 수를 센다.
+// 이 파일을 .cdsa/plugins/ 에 두면 자동으로 'word_count' 도구가 등록되어
+// 모델이 호출할 수 있게 된다. (읽기 전용이라 mutating: false → 승인 불필요)
+import fs from "node:fs";
+import path from "node:path";
+
+export default {
+  name: "word_count",
+  description: "작업 폴더 안 텍스트 파일의 글자수/줄수/단어수를 센다.",
+  parameters: {
+    type: "object",
+    properties: { path: { type: "string", description: "작업 폴더 기준 상대 경로" } },
+    required: ["path"],
+  },
+  mutating: false,
+  async handler(args, ctx) {
+    const rel = (args.path || "").trim();
+    const target = path.resolve(ctx.workspace, rel);
+    if (target !== ctx.workspace && !target.startsWith(ctx.workspace + path.sep)) {
+      return "작업 폴더 밖 경로에는 접근할 수 없습니다.";
+    }
+    if (!fs.existsSync(target) || !fs.statSync(target).isFile()) {
+      return `파일이 없습니다: ${rel}`;
+    }
+    const text = fs.readFileSync(target, "utf8");
+    const chars = text.length;
+    const lines = text.split("\n").length;
+    const words = (text.trim().match(/\S+/g) || []).length;
+    return `${rel} → 글자 ${chars}, 줄 ${lines}, 단어 ${words}`;
+  },
+};

package/workspace/.cdsa/skills/summarize.md

@@ -0,0 +1,5 @@
+---
+description: 지정한 파일을 읽고 한국어 3줄로 요약
+---
+$ARGUMENTS 파일을 read_file 도구로 읽은 다음, 핵심 내용을 한국어 3줄로 요약해줘.
+파일을 수정하지는 말고, 요약만 보여줘.