saycoder 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# saycoder
+
+A small CLI that configures OpenCode to use SayCoder as the model layer, plus practical third-party MCP servers and lightweight coding skills.
+
+## Setup flow
+
+1. Checks whether `opencode` is installed.
+2. If missing, asks whether to install it with `npm install -g opencode-ai`.
+3. Prompts the user for a SayCoder API key.
+4. Validates the key with `GET https://jstapi.xinbai.icu/v1/models`.
+5. Uses the returned model list to populate OpenCode provider models.
+6. Writes OpenCode config and installs lightweight SayCoder skills.
+7. Tells the user to choose a model and start coding.
+
+## MCP defaults
+
+- `context7`: official remote MCP at `https://mcp.context7.com/mcp` for current docs.
+- `time`: optional local MCP via `--time-mcp` and `uvx mcp-server-time` for current time and timezone conversion.
+- `tavily`: optional remote web search MCP when `--tavily-api-key` is provided.
+- `exa`: optional remote web/code search MCP when `--exa-api-key` is provided and Tavily is not set.
+
+SayCoder's base URL is only used for the OpenAI-compatible model channel, not for MCP hosting.
+
+## China mirror
+
+When OpenCode is missing, setup asks whether to install through the China npm mirror.
+You can also force it with:
+
+```bash
+node bin/saycoder.js setup --npm-registry https://registry.npmmirror.com
+```
+
+## Installed skills
+
+- `saycoder-lite-superpowers`: clarify user intent, split logical goals, implement production code, and report completed/not completed work.
+- `saycoder-code-review`: lightweight production-readiness review before handoff.
+- `saycoder-test-check`: choose and report the smallest meaningful verification.
+
+## Local test
+
+```bash
+node bin/saycoder.js setup --dry-run --skip-install-check --skip-validate --api-key test-key
+```
+
+## Intended usage
+
+```bash
+npx saycoder
+```
+
+You can also pass options directly:
+
+```bash
+npx saycoder --npm-registry https://registry.npmmirror.com
+```

package/bin/saycoder.js

@@ -0,0 +1,413 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { spawnSync } from "node:child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(__dirname, "..");
+
+const DEFAULTS = {
+  providerId: "saycoder",
+  providerName: "SayCoder",
+  baseURL: "https://jstapi.xinbai.icu/",
+  apiKeyEnv: "SAYCODER_API_KEY",
+  configPath: join(homedir(), ".config", "opencode", "opencode.json"),
+};
+
+const useColor = output.isTTY;
+const paint = (code, value) => useColor ? `\x1b[${code}m${value}\x1b[0m` : value;
+const color = {
+  blue: (value) => paint(34, value),
+  cyan: (value) => paint(36, value),
+  dim: (value) => paint(2, value),
+  green: (value) => paint(32, value),
+  red: (value) => paint(31, value),
+  yellow: (value) => paint(33, value),
+};
+
+function parseArgs(argv) {
+  const [rawCommand = "setup", ...rest] = argv;
+  const command = rawCommand.startsWith("--") ? "setup" : rawCommand;
+  const normalizedRest = rawCommand.startsWith("--") ? [rawCommand, ...rest] : rest;
+  const flags = { command };
+
+  for (let index = 0; index < normalizedRest.length; index += 1) {
+    const arg = normalizedRest[index];
+    if (!arg.startsWith("--")) continue;
+
+    const [key, inlineValue] = arg.slice(2).split("=", 2);
+    const next = normalizedRest[index + 1];
+    if (inlineValue !== undefined) {
+      flags[key] = inlineValue;
+    } else if (next && !next.startsWith("--")) {
+      flags[key] = next;
+      index += 1;
+    } else {
+      flags[key] = true;
+    }
+  }
+
+  flags["enable-time-mcp"] = Boolean(flags["time-mcp"]);
+  if (flags["no-time-mcp"]) flags["enable-time-mcp"] = false;
+
+  return flags;
+}
+
+function usage() {
+  console.log(`SayCoder OpenCode setup
+
+Usage:
+  saycoder setup [options]
+
+Options:
+  --api-key <key>          SayCoder API key. If omitted, prompts interactively.
+  --base-url <url>         OpenAI-compatible API base URL. Default: ${DEFAULTS.baseURL}
+  --model <id>             Main model ID. Default: first model from /models.
+  --small-model <id>       Small model ID. Default: same as --model.
+  --tavily-api-key <key>   Optional Tavily key for web search MCP.
+  --exa-api-key <key>      Optional Exa key for web/code search MCP.
+  --time-mcp               Enable local Time MCP via uvx mcp-server-time.
+  --no-time-mcp            Disable local Time MCP. Default behavior.
+  --config <path>          OpenCode config path. Default: ${DEFAULTS.configPath}
+  --dry-run                Print config changes without writing files.
+  --yes                    Non-interactive confirmation for future prompts.
+  --npm-registry <url>     Registry for installing OpenCode, eg https://registry.npmmirror.com.
+  --skip-install-check     Skip OpenCode installation check.
+  --skip-validate          Skip /models validation for local dry-run tests only.
+`);
+}
+
+function readJson(path) {
+  if (!existsSync(path)) return {};
+  return JSON.parse(readFileSync(path, "utf8"));
+}
+
+function sortObject(value) {
+  if (Array.isArray(value)) return value.map(sortObject);
+  if (!value || typeof value !== "object") return value;
+  return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, sortObject(nested)]));
+}
+
+function unique(values) {
+  return [...new Set(values.filter(Boolean))];
+}
+
+function commandExists(command) {
+  const result = spawnSync(process.platform === "win32" ? "where" : "command", process.platform === "win32" ? [command] : ["-v", command], {
+    shell: process.platform !== "win32",
+    stdio: "ignore",
+  });
+  return result.status === 0;
+}
+
+function installOpenCode(registry) {
+  const args = ["install", "-g", "opencode-ai"];
+  if (registry) args.push("--registry", registry);
+  step(`Installing OpenCode with npm${registry ? ` using ${registry}` : ""}...`);
+  const result = spawnSync("npm", args, { stdio: "inherit" });
+  if (result.status !== 0) throw new Error("OpenCode installation failed. Please install it manually and retry.");
+}
+
+function step(message) {
+  console.log(`${color.cyan("→")} ${message}`);
+}
+
+function success(message) {
+  console.log(`${color.green("✓")} ${message}`);
+}
+
+function warn(message) {
+  console.log(`${color.yellow("!")} ${message}`);
+}
+
+async function prompt(question) {
+  if (!input.isTTY) return "";
+  const rl = createInterface({ input, output });
+  try {
+    return (await rl.question(question)).trim();
+  } finally {
+    rl.close();
+  }
+}
+
+async function confirm(question, assumeYes) {
+  if (assumeYes) return true;
+  const answer = (await prompt(`${question} [y/N] `)).toLowerCase();
+  return answer === "y" || answer === "yes";
+}
+
+async function optionalSecret(flags, key, question) {
+  if (flags[key] !== undefined) return flags[key];
+  if (flags.yes || !input.isTTY) return "";
+  return await prompt(`${question} ${color.dim("(optional, press Enter to skip):")} `);
+}
+
+function normalizeBaseURL(baseURL) {
+  const trimmed = baseURL.replace(/\/+$/, "");
+  return trimmed.endsWith("/v1") ? trimmed : `${trimmed}/v1`;
+}
+
+function modelsURL(baseURL) {
+  return `${normalizeBaseURL(baseURL)}/models`;
+}
+
+async function fetchModels(baseURL, apiKey) {
+  const url = modelsURL(baseURL);
+  const response = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      Accept: "application/json",
+    },
+  });
+
+  const contentType = response.headers.get("content-type") || "";
+  const body = await response.text();
+
+  if (!response.ok) {
+    let detail = body.slice(0, 160).replace(/\s+/g, " ").trim();
+    try {
+      detail = JSON.parse(body).error?.message || detail;
+    } catch {}
+    throw new Error(`API key validation failed: GET ${url} returned HTTP ${response.status}${detail ? ` (${detail})` : ""}`);
+  }
+
+  if (!contentType.includes("application/json")) {
+    const preview = body.slice(0, 80).replace(/\s+/g, " ").trim();
+    throw new Error(`API key validation failed: GET ${url} did not return JSON. Check that the base URL is an OpenAI-compatible /v1 endpoint. Response starts with: ${preview}`);
+  }
+
+  let payload;
+  try {
+    payload = JSON.parse(body);
+  } catch (error) {
+    throw new Error(`API key validation failed: GET ${url} returned invalid JSON (${error.message}).`);
+  }
+  const models = Array.isArray(payload.data) ? payload.data.map((item) => item.id).filter(Boolean) : [];
+  if (models.length === 0) throw new Error(`API key validation failed: GET ${url} returned no model ids.`);
+  return models;
+}
+
+function buildMcpConfig(flags) {
+  const mcp = {
+    context7: {
+      type: "remote",
+      url: "https://mcp.context7.com/mcp",
+      enabled: true,
+    },
+  };
+
+  if (flags["enable-time-mcp"] !== false) {
+    mcp.time = {
+      type: "local",
+      command: ["uvx", "mcp-server-time"],
+      enabled: true,
+    };
+  }
+
+  if (flags["tavily-api-key"]) {
+    mcp.tavily = {
+      type: "remote",
+      url: "https://mcp.tavily.com/mcp/",
+      headers: {
+        Authorization: `Bearer ${flags["tavily-api-key"]}`,
+      },
+      enabled: true,
+    };
+  } else if (flags["exa-api-key"]) {
+    mcp.exa = {
+      type: "remote",
+      url: "https://mcp.exa.ai/mcp",
+      headers: {
+        Authorization: `Bearer ${flags["exa-api-key"]}`,
+      },
+      enabled: true,
+    };
+  }
+
+  return mcp;
+}
+
+function modelConfig(name) {
+  return {
+    name,
+    tool_call: true,
+    reasoning: true,
+    attachment: true,
+    limit: {
+      context: 128000,
+      output: 8192,
+    },
+  };
+}
+
+function buildSayCoderConfig(flags, models) {
+  const providerId = DEFAULTS.providerId;
+  const apiKey = flags["api-key"];
+  const baseURL = normalizeBaseURL(flags["base-url"] || DEFAULTS.baseURL);
+  const model = flags.model || models[0];
+  const smallModel = flags["small-model"] || model;
+  const modelMap = Object.fromEntries(models.map((name) => [name, modelConfig(name)]));
+
+  return {
+    model: `${providerId}/${model}`,
+    small_model: `${providerId}/${smallModel}`,
+    default_agent: "saycoder",
+    provider: {
+      [providerId]: {
+        npm: "@ai-sdk/openai-compatible",
+        name: DEFAULTS.providerName,
+        options: {
+          baseURL,
+          apiKey,
+          timeout: 300000,
+          chunkTimeout: 60000,
+        },
+        models: modelMap,
+      },
+    },
+    mcp: buildMcpConfig(flags),
+    agent: {
+      saycoder: {
+        mode: "primary",
+        description: "Production coding agent powered by SayCoder models, MCP, and lightweight skills.",
+        model: `${providerId}/${model}`,
+        permission: {
+          bash: "ask",
+          edit: "ask",
+          webfetch: "allow",
+          websearch: "allow",
+        },
+        prompt: [
+          "Use the saycoder-lite-superpowers skill for coding tasks.",
+          "Use saycoder-code-review before claiming production readiness when code was changed.",
+          "Use saycoder-test-check when selecting the smallest meaningful verification.",
+          "Clarify the user's real requirement when ambiguous.",
+          "Split work into logical goals, implement production-grade code, verify narrowly, and report completed/not completed items.",
+        ].join("\n"),
+      },
+    },
+  };
+}
+
+function mergeConfig(existing, incoming) {
+  const merged = {
+    ...existing,
+    ...incoming,
+    provider: {
+      ...(existing.provider || {}),
+      ...incoming.provider,
+    },
+    mcp: {
+      ...(existing.mcp || {}),
+      ...incoming.mcp,
+    },
+    agent: {
+      ...(existing.agent || {}),
+      ...incoming.agent,
+    },
+    plugin: unique([...(existing.plugin || []), ...(incoming.plugin || [])]),
+  };
+  if (merged.plugin.length === 0) delete merged.plugin;
+  return merged;
+}
+
+function installSkills(configDir, dryRun) {
+  const skillNames = ["saycoder-lite-superpowers", "saycoder-code-review", "saycoder-test-check"];
+  const targets = [];
+
+  for (const skillName of skillNames) {
+    const source = join(packageRoot, "templates", "skills", skillName, "SKILL.md");
+    const targetDir = join(configDir, "skills", skillName);
+    const target = join(targetDir, "SKILL.md");
+    targets.push(target);
+
+    if (!dryRun) {
+      mkdirSync(targetDir, { recursive: true });
+      copyFileSync(source, target);
+    }
+  }
+
+  return targets;
+}
+
+async function setup(flags) {
+  const configPath = resolve(flags.config || DEFAULTS.configPath);
+  const configDir = dirname(configPath);
+
+  console.log(color.blue("\nSayCoder OpenCode Setup\n"));
+
+  if (!flags["skip-install-check"] && !commandExists("opencode")) {
+    const shouldInstall = await confirm("OpenCode is not installed. Install it now with npm?", Boolean(flags.yes));
+    if (!shouldInstall) {
+      console.log("Setup cancelled. Install OpenCode first, then rerun `saycoder setup`.");
+      return;
+    }
+
+    if (!flags["npm-registry"] && input.isTTY) {
+      const useMirror = await confirm("Use China npm mirror for faster download?", false);
+      if (useMirror) flags["npm-registry"] = "https://registry.npmmirror.com";
+    }
+
+    installOpenCode(flags["npm-registry"]);
+    success("OpenCode installed.");
+  } else if (!flags["skip-install-check"]) {
+    success("OpenCode is installed.");
+  }
+
+  if (!flags["api-key"]) {
+    flags["api-key"] = await prompt("Enter your SayCoder API key: ");
+  }
+  if (!flags["api-key"]) throw new Error("API key is required.");
+
+  if (flags["enable-time-mcp"] && !commandExists("uvx")) {
+    const keepTime = await confirm("uvx is not installed. Keep Time MCP config anyway?", Boolean(flags.yes));
+    if (!keepTime) {
+      flags["enable-time-mcp"] = false;
+      warn("Time MCP skipped. Install uv later or rerun setup without --no-time-mcp.");
+    }
+  }
+
+  const baseURL = flags["base-url"] || DEFAULTS.baseURL;
+  const models = flags["skip-validate"] ? [flags.model || "example-model"] : null;
+  if (models) {
+    warn(`Skipping API key validation. Using test model(s): ${models.join(", ")}`);
+  } else {
+    step(`Validating API key with ${modelsURL(baseURL)} ...`);
+  }
+  const validatedModels = models || await fetchModels(baseURL, flags["api-key"]);
+  if (!models) success(`API key is valid. Found ${validatedModels.length} model(s): ${validatedModels.join(", ")}`);
+
+  step("Writing OpenCode provider, MCP, agent, and skills config...");
+  const incoming = buildSayCoderConfig(flags, validatedModels);
+  const existing = readJson(configPath);
+  const merged = sortObject(mergeConfig(existing, incoming));
+  const skillPaths = installSkills(configDir, Boolean(flags["dry-run"]));
+
+  if (flags["dry-run"]) {
+    console.log(JSON.stringify(merged, null, 2));
+    console.log(`\nDry run only. Skills would be installed to:\n${skillPaths.map((item) => `- ${item}`).join("\n")}`);
+    return;
+  }
+
+  mkdirSync(configDir, { recursive: true });
+  writeFileSync(configPath, `${JSON.stringify(merged, null, 2)}\n`);
+
+  success(`Updated OpenCode config: ${configPath}`);
+  success(`Installed ${skillPaths.length} skills.`);
+  console.log(color.green("\n模型选择中意模型，即可开始编程了！\n"));
+}
+
+const flags = parseArgs(process.argv.slice(2));
+
+try {
+  if (flags.command === "setup") await setup(flags);
+  else usage();
+} catch (error) {
+  console.error(color.red(`saycoder: ${error.message}`));
+  process.exitCode = 1;
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "saycoder",
+  "version": "0.1.0",
+  "description": "SayCoder setup helper for OpenCode models, MCP servers, and skills.",
+  "type": "module",
+  "bin": {
+    "saycoder": "bin/saycoder.js"
+  },
+  "scripts": {
+    "check": "node --check bin/saycoder.js",
+    "setup:local": "node bin/saycoder.js setup --dry-run --skip-install-check --skip-validate --api-key=test-key"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED",
+  "private": false,
+  "files": [
+    "bin",
+    "templates"
+  ]
+}

package/templates/skills/saycoder-code-review/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: saycoder-code-review
+description: Lightweight production-readiness review for changed code before claiming work is complete.
+---
+
+# SayCoder Code Review
+
+Use this skill after making code changes and before saying the work is production-ready.
+
+## Review Checklist
+
+1. Confirm the change directly satisfies the user's requested outcome.
+2. Check for unnecessary scope expansion, hidden rewrites, or unrelated fixes.
+3. Inspect error handling, edge cases, security-sensitive inputs, and config merging.
+4. Check that names, structure, and style match the surrounding project.
+5. Confirm the final response can clearly separate completed work from unfinished work.
+
+## Output
+
+Keep the review short:
+
+- Pass: what looks ready
+- Fix: what must change before handoff
+- Risk: what remains uncertain after available verification

package/templates/skills/saycoder-lite-superpowers/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: saycoder-lite-superpowers
+description: Lightweight production coding workflow for OpenCode: clarify intent, split logical goals, implement safely, and report done/not done.
+---
+
+# SayCoder Lite Superpowers
+
+Use this skill for coding tasks that should become production-quality changes without the overhead of a heavy process.
+
+## Workflow
+
+1. Confirm the user's actual outcome in one sentence when the request is ambiguous.
+2. Split the task into logical goals that can be verified independently.
+3. Inspect the existing project before editing; follow local conventions.
+4. Implement the smallest production-grade change that satisfies the goals.
+5. Verify with the narrowest meaningful check available.
+6. Finish by stating exactly:
+   - What I completed
+   - What I did not complete
+   - Any verification run or blocker
+
+## Guardrails
+
+- Do not claim completion without verification or a named blocker.
+- Do not hide partial work; call it out clearly.
+- Prefer root-cause fixes over surface patches.
+- Avoid broad rewrites unless explicitly requested.
+- Ask only for decisions that block safe progress.

package/templates/skills/saycoder-test-check/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: saycoder-test-check
+description: Choose the smallest meaningful verification for production coding tasks and report the exact result.
+---
+
+# SayCoder Test Check
+
+Use this skill when deciding how to verify a coding change.
+
+## Verification Ladder
+
+Pick the narrowest check that proves the changed behavior:
+
+1. Syntax check for parser/runtime errors.
+2. Targeted unit or integration test for changed logic.
+3. Focused command or dry-run for generated config/CLI behavior.
+4. Broader test/lint/build only when the change touches shared behavior.
+5. Manual inspection only when no executable check is available.
+
+## Reporting
+
+Always report:
+
+- Command or inspection performed
+- Result observed
+- What was not verified and why