helloloop 0.3.1 → 0.6.1

package/src/install_codex.mjs

@@ -0,0 +1,114 @@
+import path from "node:path";
+
+import { ensureDir, fileExists, readJson, writeJson } from "./common.mjs";
+import {
+  assertPathInside,
+  codexBundleEntries,
+  copyBundleEntries,
+  removePathIfExists,
+  removeTargetIfNeeded,
+  resolveHomeDir,
+} from "./install_shared.mjs";
+
+function updateCodexMarketplace(marketplaceFile) {
+  const marketplace = fileExists(marketplaceFile)
+    ? readJson(marketplaceFile)
+    : {
+      name: "local-plugins",
+      interface: {
+        displayName: "Local Plugins",
+      },
+      plugins: [],
+    };
+
+  marketplace.interface = marketplace.interface || {
+    displayName: "Local Plugins",
+  };
+  marketplace.plugins = Array.isArray(marketplace.plugins) ? marketplace.plugins : [];
+
+  const nextEntry = {
+    name: "helloloop",
+    source: {
+      source: "local",
+      path: "./plugins/helloloop",
+    },
+    policy: {
+      installation: "AVAILABLE",
+      authentication: "ON_INSTALL",
+    },
+    category: "Coding",
+  };
+
+  const existingIndex = marketplace.plugins.findIndex((plugin) => plugin?.name === "helloloop");
+  if (existingIndex >= 0) {
+    marketplace.plugins.splice(existingIndex, 1, nextEntry);
+  } else {
+    marketplace.plugins.push(nextEntry);
+  }
+
+  writeJson(marketplaceFile, marketplace);
+}
+
+function removeCodexMarketplaceEntry(marketplaceFile) {
+  if (!fileExists(marketplaceFile)) {
+    return false;
+  }
+
+  const marketplace = readJson(marketplaceFile);
+  const plugins = Array.isArray(marketplace.plugins) ? marketplace.plugins : [];
+  const nextPlugins = plugins.filter((plugin) => plugin?.name !== "helloloop");
+  if (nextPlugins.length === plugins.length) {
+    return false;
+  }
+
+  marketplace.plugins = nextPlugins;
+  writeJson(marketplaceFile, marketplace);
+  return true;
+}
+
+export function installCodexHost(bundleRoot, options = {}) {
+  const resolvedCodexHome = resolveHomeDir(options.codexHome, ".codex");
+  const targetPluginsRoot = path.join(resolvedCodexHome, "plugins");
+  const targetPluginRoot = path.join(targetPluginsRoot, "helloloop");
+  const marketplaceFile = path.join(resolvedCodexHome, ".agents", "plugins", "marketplace.json");
+  const manifestFile = path.join(bundleRoot, ".codex-plugin", "plugin.json");
+
+  if (!fileExists(manifestFile)) {
+    throw new Error(`未找到 Codex 插件 manifest：${manifestFile}`);
+  }
+
+  assertPathInside(resolvedCodexHome, targetPluginRoot, "Codex 目标插件目录");
+  removeTargetIfNeeded(targetPluginRoot, options.force);
+
+  ensureDir(targetPluginsRoot);
+  ensureDir(targetPluginRoot);
+  copyBundleEntries(bundleRoot, targetPluginRoot, codexBundleEntries);
+  removePathIfExists(path.join(targetPluginRoot, ".git"));
+
+  ensureDir(path.dirname(marketplaceFile));
+  updateCodexMarketplace(marketplaceFile);
+
+  return {
+    host: "codex",
+    displayName: "Codex",
+    targetRoot: targetPluginRoot,
+    marketplaceFile,
+  };
+}
+
+export function uninstallCodexHost(options = {}) {
+  const resolvedCodexHome = resolveHomeDir(options.codexHome, ".codex");
+  const targetPluginRoot = path.join(resolvedCodexHome, "plugins", "helloloop");
+  const marketplaceFile = path.join(resolvedCodexHome, ".agents", "plugins", "marketplace.json");
+
+  const removedPlugin = removePathIfExists(targetPluginRoot);
+  const removedMarketplace = removeCodexMarketplaceEntry(marketplaceFile);
+
+  return {
+    host: "codex",
+    displayName: "Codex",
+    targetRoot: targetPluginRoot,
+    removed: removedPlugin || removedMarketplace,
+    marketplaceFile,
+  };
+}

package/src/install_gemini.mjs

@@ -0,0 +1,43 @@
+import path from "node:path";
+
+import { ensureDir, fileExists } from "./common.mjs";
+import {
+  assertPathInside,
+  copyDirectory,
+  removePathIfExists,
+  removeTargetIfNeeded,
+  resolveHomeDir,
+} from "./install_shared.mjs";
+
+export function installGeminiHost(bundleRoot, options = {}) {
+  const resolvedGeminiHome = resolveHomeDir(options.geminiHome, ".gemini");
+  const sourceExtensionRoot = path.join(bundleRoot, "hosts", "gemini", "extension");
+  const targetExtensionRoot = path.join(resolvedGeminiHome, "extensions", "helloloop");
+
+  if (!fileExists(path.join(sourceExtensionRoot, "gemini-extension.json"))) {
+    throw new Error(`未找到 Gemini 扩展清单：${sourceExtensionRoot}`);
+  }
+
+  assertPathInside(resolvedGeminiHome, targetExtensionRoot, "Gemini 扩展目录");
+  removeTargetIfNeeded(targetExtensionRoot, options.force);
+  ensureDir(path.dirname(targetExtensionRoot));
+  copyDirectory(sourceExtensionRoot, targetExtensionRoot);
+
+  return {
+    host: "gemini",
+    displayName: "Gemini",
+    targetRoot: targetExtensionRoot,
+  };
+}
+
+export function uninstallGeminiHost(options = {}) {
+  const resolvedGeminiHome = resolveHomeDir(options.geminiHome, ".gemini");
+  const targetExtensionRoot = path.join(resolvedGeminiHome, "extensions", "helloloop");
+
+  return {
+    host: "gemini",
+    displayName: "Gemini",
+    targetRoot: targetExtensionRoot,
+    removed: removePathIfExists(targetExtensionRoot),
+  };
+}

package/src/install_shared.mjs

@@ -0,0 +1,90 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+import { ensureDir, fileExists, readJson, writeJson } from "./common.mjs";
+
+export const runtimeBundleEntries = [
+  ".claude-plugin",
+  ".codex-plugin",
+  "LICENSE",
+  "README.md",
+  "bin",
+  "hosts",
+  "package.json",
+  "scripts",
+  "skills",
+  "src",
+  "templates",
+];
+
+export const codexBundleEntries = runtimeBundleEntries.filter((entry) => ![
+  ".claude-plugin",
+  "hosts",
+].includes(entry));
+
+export const supportedHosts = ["codex", "claude", "gemini"];
+export const CLAUDE_MARKETPLACE_NAME = "helloloop-local";
+export const CLAUDE_PLUGIN_KEY = "helloloop@helloloop-local";
+
+export function resolveHomeDir(homeDir, defaultDirName) {
+  return path.resolve(homeDir || path.join(os.homedir(), defaultDirName));
+}
+
+export function assertPathInside(parentDir, targetDir, label) {
+  const relative = path.relative(parentDir, targetDir);
+  if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) {
+    throw new Error(`${label} 超出允许范围：${targetDir}`);
+  }
+}
+
+export function removeTargetIfNeeded(targetPath, force) {
+  if (!fileExists(targetPath)) {
+    return;
+  }
+  if (!force) {
+    throw new Error(`目标目录已存在：${targetPath}。若要覆盖，请追加 --force。`);
+  }
+  fs.rmSync(targetPath, { recursive: true, force: true });
+}
+
+export function removePathIfExists(targetPath) {
+  if (!fileExists(targetPath)) {
+    return false;
+  }
+  fs.rmSync(targetPath, { recursive: true, force: true });
+  return true;
+}
+
+export function copyBundleEntries(bundleRoot, targetRoot, entries) {
+  for (const entry of entries) {
+    const sourcePath = path.join(bundleRoot, entry);
+    if (!fileExists(sourcePath)) {
+      continue;
+    }
+
+    fs.cpSync(sourcePath, path.join(targetRoot, entry), {
+      force: true,
+      recursive: true,
+    });
+  }
+}
+
+export function copyDirectory(sourceRoot, targetRoot) {
+  fs.cpSync(sourceRoot, targetRoot, {
+    force: true,
+    recursive: true,
+  });
+}
+
+export function loadOrInitJson(filePath, fallbackValue) {
+  if (!fileExists(filePath)) {
+    return fallbackValue;
+  }
+  return readJson(filePath);
+}
+
+export function writeJsonFile(filePath, value) {
+  ensureDir(path.dirname(filePath));
+  writeJson(filePath, value);
+}