dsh-desktop-kit 0.0.0-stage → 2.0.0

package/plugins/dsh-gkb-ru-ui/lib/index.js

@@ -0,0 +1,186 @@
+/**
+ * dsh-gkb-ru-ui — Host half.
+ *
+ * Russian language pack marker + Skills catalog RPC:
+ *   skills      — inventory of ~/.dsh/skills with usage statistics from sessions
+ *   skill       — one skill with its SKILL.md content
+ *   open-skill  — reveal a skill folder / SKILL.md in the OS file manager
+ */
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { collectSkillsData, listSkills, readSkillContent, skillsHome, saveSkillContent, createSkill, duplicateSkill, deleteSkill } from "./skills.js";
+
+const ROUTE_BASE = "/api/dsh-gkb-ru-ui";
+const RPC_NAMESPACE = "dsh-gkb-ru-ui";
+
+export const inject = ["connection"];
+
+function okEnvelope(rpcId, value) {
+  return Response.json({ type: "server-response", rpcId, result: { ok: true, value } });
+}
+
+function errorEnvelope(rpcId, code, message) {
+  return Response.json({ type: "server-response", rpcId, result: { ok: false, error: { code, message } } });
+}
+
+async function readEnvelope(request) {
+  let body;
+  try {
+    body = await request.json();
+  } catch {
+    const error = new Error("тело запроса не JSON");
+    error.code = "skills/bad-request";
+    throw error;
+  }
+  if (body === null || typeof body !== "object" || body.type !== "client-request" || typeof body.rpcId !== "string" || typeof body.method !== "string") {
+    const error = new Error("некорректный конверт Connection");
+    error.code = "skills/bad-request";
+    throw error;
+  }
+  return { rpcId: body.rpcId, method: body.method, payload: body.payload ?? {} };
+}
+
+function openInExplorer(target, isFile) {
+  const platform = process.platform;
+  if (platform === "win32") {
+    const child = spawn("explorer.exe", [isFile ? `/select,${target}` : target], { detached: true, stdio: "ignore" });
+    child.unref?.();
+    return true;
+  }
+  const command = platform === "darwin" ? "open" : "xdg-open";
+  const child = spawn(command, [isFile ? path.dirname(target) : target], { detached: true, stdio: "ignore" });
+  child.unref?.();
+  return true;
+}
+
+function registerOperation(ctx, operation, handler) {
+  const route = {
+    path: `${ROUTE_BASE}/${operation}`,
+    methods: ["POST"],
+    requestBody: "buffered",
+    fetch: async (request) => {
+      let rpcId = "invalid-request";
+      try {
+        const envelope = await readEnvelope(request);
+        rpcId = envelope.rpcId;
+        if (envelope.method !== `${RPC_NAMESPACE}/${operation}`) {
+          return errorEnvelope(rpcId, "skills/bad-request", "метод конверта не совпадает с endpoint");
+        }
+        const value = await handler(envelope.payload);
+        return okEnvelope(rpcId, value);
+      } catch (error) {
+        const code = typeof error?.code === "string" ? error.code : "skills/internal";
+        if (code === "skills/internal") ctx.logger?.warn?.(`[gkb-skills] ${operation} failed: ${String(error)}`);
+        return errorEnvelope(rpcId, code, error instanceof Error ? error.message : String(error));
+      }
+    },
+  };
+  ctx.effect(() => {
+    const dispose = ctx.connection.fetch.register(route);
+    return () => {
+      try {
+        void Promise.resolve(dispose()).catch(() => {});
+      } catch {
+        /* carrier unloading */
+      }
+    };
+  }, `gkb-ru: ${operation} route`);
+}
+
+export function apply(ctx) {
+  try {
+    fs.writeFileSync(
+      path.join(os.tmpdir(), "dsh-gkb-ru-ui-loaded.json"),
+      JSON.stringify({ at: new Date().toISOString(), pid: process.pid, version: "1.8.0" }),
+      "utf8",
+    );
+  } catch {
+    /* marker is best effort */
+  }
+
+  registerOperation(ctx, "skills", async (payload) => {
+    const sessionId = typeof payload?.sessionId === "string" && payload.sessionId.length > 0 ? payload.sessionId : null;
+    const home = skillsHome();
+    const data = collectSkillsData(home, sessionId);
+    return { ...data, home };
+  });
+
+  registerOperation(ctx, "skill", async (payload) => {
+    const name = typeof payload?.name === "string" ? payload.name : "";
+    if (name.length === 0) {
+      const error = new Error("не указано имя навыка");
+      error.code = "skills/bad-request";
+      throw error;
+    }
+    const home = skillsHome();
+    const skill = readSkillContent(home, name);
+    if (skill === null) {
+      const error = new Error(`навык «${name}» не найден`);
+      error.code = "skills/not-found";
+      throw error;
+    }
+    const data = collectSkillsData(home, typeof payload?.sessionId === "string" ? payload.sessionId : null);
+    const usage = data.skills.find((item) => item.name === skill.name)?.usage ?? null;
+    return { skill, usage };
+  });
+
+  registerOperation(ctx, "skill-save", async (payload) => {
+    const name = typeof payload?.name === "string" ? payload.name : "";
+    const content = typeof payload?.content === "string" ? payload.content : "";
+    if (name.length === 0) {
+      const error = new Error("не указано имя навыка");
+      error.code = "skills/bad-request";
+      throw error;
+    }
+    const saved = saveSkillContent(skillsHome(), name, content);
+    const data = collectSkillsData(skillsHome(), typeof payload?.sessionId === "string" ? payload.sessionId : null);
+    return { ...saved, totals: data.totals };
+  });
+
+  registerOperation(ctx, "skill-create", async (payload) => {
+    const skill = createSkill(skillsHome(), payload);
+    const data = collectSkillsData(skillsHome(), typeof payload?.sessionId === "string" ? payload.sessionId : null);
+    return { skill, totals: data.totals };
+  });
+
+  registerOperation(ctx, "skill-duplicate", async (payload) => {
+    const source = typeof payload?.source === "string" ? payload.source : "";
+    const name = typeof payload?.name === "string" ? payload.name : "";
+    if (source.length === 0) {
+      const error = new Error("не указан исходный навык");
+      error.code = "skills/bad-request";
+      throw error;
+    }
+    const skill = duplicateSkill(skillsHome(), source, name);
+    const data = collectSkillsData(skillsHome(), typeof payload?.sessionId === "string" ? payload.sessionId : null);
+    return { skill, totals: data.totals };
+  });
+
+  registerOperation(ctx, "skill-delete", async (payload) => {
+    const name = typeof payload?.name === "string" ? payload.name : "";
+    if (name.length === 0) {
+      const error = new Error("не указано имя навыка");
+      error.code = "skills/bad-request";
+      throw error;
+    }
+    const result = deleteSkill(skillsHome(), name);
+    const data = collectSkillsData(skillsHome(), typeof payload?.sessionId === "string" ? payload.sessionId : null);
+    return { ...result, totals: data.totals };
+  });
+
+  registerOperation(ctx, "open-skill", async (payload) => {
+    const name = typeof payload?.name === "string" ? payload.name : "";
+    const home = skillsHome();
+    const skill = listSkills(home).find((item) => item.name === name || item.directory === name);
+    if (skill === undefined) {
+      const error = new Error(`навык «${name}» не найден`);
+      error.code = "skills/not-found";
+      throw error;
+    }
+    openInExplorer(skill.skillFile, true);
+    return { opened: true, path: skill.path };
+  });
+}