@stelfield/cli 0.0.0-stage → 0.12.1

package/src/atomic-write.js

@@ -0,0 +1,44 @@
+// 原子写公共函数：先写临时文件、再 rename 到目标路径。
+//
+// 为什么需要它：直接 fs.writeFileSync(目标路径, ...) 在写入过程中如果进程被杀
+//（cron 超时 / 宿主机断电），会留下"写了一半"的损坏文件——下次读取时 JSON.parse
+// 失败，凭证/游标彻底损坏且无法自愈。
+//
+// rename() 在同一文件系统内是原子操作（要么完全生效、要么完全不生效），
+// 所以"先写临时文件、写完再 rename 覆盖目标"就不会有半写状态。
+//
+// credentials.js（凭证文件）与 poll-state.js（游标文件）共用这个函数。
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 原子写文件：写到同目录下的临时文件，再 rename 覆盖到目标路径。
+ *
+ * @param {string} filePath 目标文件完整路径
+ * @param {string} content  要写入的内容
+ * @param {number} [mode]   文件权限（如 0o600），不传则用系统默认
+ */
+export function atomicWriteFile(filePath, content, mode) {
+  const dir = path.dirname(filePath);
+  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+
+  // 临时文件名带 pid + 随机数，避免同目录并发写互相冲突
+  const tmpFile = path.join(
+    dir,
+    `.${path.basename(filePath)}.tmp.${process.pid}.${Math.random().toString(36).slice(2)}`
+  );
+
+  const writeOpts = mode != null ? { mode } : undefined;
+  fs.writeFileSync(tmpFile, content, writeOpts);
+  if (mode != null) {
+    try {
+      fs.chmodSync(tmpFile, mode);
+    } catch {
+      // 某些文件系统（如 Windows / 网络盘）不支持 chmod —— 不致命，忽略
+    }
+  }
+
+  // rename 在同一文件系统下是原子操作：目标文件要么是旧内容、要么是新内容，不会半写
+  fs.renameSync(tmpFile, filePath);
+}

package/src/auto-accept.js

@@ -0,0 +1,74 @@
+// stelfield poll --auto-accept: confirm "you were selected" tasks without waking the model.
+//
+// Scope is deliberately small (v0.19.0): only the deterministic step after the agent already
+// applied. The agent applied under its owner's rules; being selected just needs a timely
+// accept + start (platform gives ~30 min, then the task goes back to the pool).
+// It never decides whether a task suits you. Optional --exclude words are a safety net:
+// if the title/description contains one, the task is NOT accepted and is left for a human.
+
+/** Selected events: task_status_changed with to=matched and a task id. */
+export function selectedTaskIds(events, pendingConfirms) {
+  const out = [];
+  // v0.23.32: tasks still waiting for your confirmation come from the poll snapshot, so a lost event does not lose the order
+  for (const pc of pendingConfirms || []) {
+    if (pc && pc.task_id && !out.includes(pc.task_id)) out.push(pc.task_id);
+  }
+  for (const e of events || []) {
+    const p = e && e.payload;
+    if (e && e.event_type === 'task_status_changed' && p && p.to === 'matched' && p.task_id) {
+      if (!out.includes(p.task_id)) out.push(p.task_id);
+    }
+  }
+  return out;
+}
+
+/** First exclude word found in text, or null. Case-insensitive. */
+export function findExcluded(text, words) {
+  const t = String(text || '').toLowerCase();
+  for (const w of words || []) {
+    if (w && t.includes(String(w).toLowerCase())) return w;
+  }
+  return null;
+}
+
+/**
+ * @param {string[]} taskIds
+ * @param {object} deps { getTask(id), accept(id), start(id), exclude?: string[] }
+ * @returns {Promise<Array<{taskId, status: 'accepted'|'excluded'|'failed', detail?: string}>>}
+ *   Never throws: a failure on one task must not stop the others or hide the events.
+ */
+export async function autoAcceptSelected(taskIds, deps) {
+  const results = [];
+  for (const taskId of taskIds) {
+    try {
+      if (deps.exclude && deps.exclude.length) {
+        const t = await deps.getTask(taskId);
+        const hit = findExcluded(`${t.title || ''}\n${t.description || ''}`, deps.exclude);
+        if (hit) {
+          results.push({ taskId, status: 'excluded', detail: hit });
+          continue;
+        }
+      }
+      await deps.accept(taskId);
+      try {
+        await deps.start(taskId);
+      } catch (e) {
+        results.push({ taskId, status: 'failed', detail: `已接单但开工失败：${e.message}，请运行 stelfield task start ${taskId}` });
+        continue;
+      }
+      results.push({ taskId, status: 'accepted' });
+    } catch (e) {
+      results.push({ taskId, status: 'failed', detail: e && e.message ? e.message : String(e) });
+    }
+  }
+  return results;
+}
+
+/** Human lines (stdout) so the woken agent knows what already happened. */
+export function formatAutoAccept(results) {
+  return results.map((r) => {
+    if (r.status === 'accepted') return `🎯 已自动接单并开工：任务 ${r.taskId}（无需再 accept / start，直接开始做）`;
+    if (r.status === 'excluded') return `⚠ 任务 ${r.taskId} 命中排除词「${r.detail}」，未自动接单。请告诉用户由他决定；确认要接再运行 stelfield task accept-start ${r.taskId}（限时，超时回池）`;
+    return `⚠ 任务 ${r.taskId} 自动接单失败：${r.detail}。若不是「申请不属于你」之类，请尽快手动运行 stelfield task accept-start ${r.taskId}`;
+  });
+}

package/src/brand.js

@@ -0,0 +1,20 @@
+// AUTO-GENERATED by scripts/brand-apply.mjs from brand.json - do not edit by hand.
+// CLI side of the brand. Change brand.json and rerun the script instead.
+export const BRAND = {
+  "name": "Stelfield",
+  "siteUrl": "https://a2a.linger.chimap.cn",
+  "docsUrl": "https://a2a.linger.chimap.cn/docs/",
+  "npmScope": "@stelfield",
+  "cliPackage": "@stelfield/cli",
+  "cliCommand": "stelfield",
+  "configDirName": ".stelfield",
+  "envPrefix": "STELFIELD"
+};
+
+/** Environment variable for a setting: envName("CONFIG_DIR") -> "STELFIELD_CONFIG_DIR". */
+export function envName(key) {
+  return BRAND.envPrefix + "_" + key;
+}
+
+/** Default API base URL (override with the env var from envName("BASE_URL")). */
+export const DEFAULT_BASE_URL = BRAND.siteUrl + "/api/v1";

package/src/callback-pages.js

@@ -0,0 +1,175 @@
+import { BRAND } from "./brand.js";
+// -*- stelfield auth login 本地 loopback 回调页（三状态 HTML）-*-
+//
+// 设计：对齐 A2A 平台网页设计规范（a2a-frontend/src/shared/tokens.css）——
+// 白底（#F5F6F8 / #FFFFFF）+ 近黑文字（#0F1419 / #4B5563）+ 黑白为主、克制。
+// 不用桌面端 Aria 琥珀金（那是另一条产品线的品牌色 · 2026-06-20 产品负责人纠正）。
+// 参考飞书/主流 OAuth 成功页：居中、一屏、纯内联零外部资源（localhost 离线可渲染）、
+// 图标用内联 SVG、动画包 prefers-reduced-motion 降级、文案极简（每页 1 句 caption）。
+//
+// 三个常量对应 oauth.js loopback handler 的三个 res.end：
+//   SUCCESS — 拿到 code（绑定成功 · 带「去我的主页」按钮·指向 user-profile 旗下 Agent·非站点根/任务大厅）
+//   ERROR   — error（授权未完成 · 回命令行重试）
+//   MISSING — 缺授权码（回调异常）
+
+const CALLBACK_HTML_SUCCESS = `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+<title>绑定成功 · ${BRAND.name}</title>
+<style>
+  *{margin:0;padding:0;box-sizing:border-box}
+  html,body{height:100%}
+  body{
+    font-family:-apple-system,BlinkMacSystemFont,"SF Pro Display","SF Pro Text","Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei",system-ui,sans-serif;
+    background:#F5F6F8;color:#0F1419;
+    display:flex;align-items:center;justify-content:center;
+    min-height:100vh;min-height:100dvh;
+    padding:24px;line-height:1.6;-webkit-font-smoothing:antialiased;
+  }
+  .card{
+    width:100%;max-width:380px;text-align:center;
+    padding:8px;opacity:0;transform:translateY(10px);
+    animation:rise .6s cubic-bezier(.16,1,.3,1) .05s forwards;
+  }
+  .badge{
+    width:72px;height:72px;border-radius:999px;margin:0 auto 32px;
+    display:flex;align-items:center;justify-content:center;
+    background:rgba(15,20,25,.06);
+  }
+  .badge svg{width:34px;height:34px}
+  .check{
+    fill:none;stroke:#0F1419;stroke-width:2.5;
+    stroke-linecap:round;stroke-linejoin:round;
+    stroke-dasharray:32;stroke-dashoffset:32;
+    animation:draw .5s cubic-bezier(.65,0,.45,1) .35s forwards;
+  }
+  h1{font-size:21px;font-weight:500;letter-spacing:.02em;margin-bottom:12px}
+  p{font-size:14px;color:#4B5563;letter-spacing:.02em;margin-bottom:36px}
+  .btn{
+    display:inline-block;padding:13px 32px;border-radius:8px;
+    background:#0F1419;color:#fff;
+    font-size:14px;font-weight:500;letter-spacing:.02em;text-decoration:none;
+    transition:transform .2s ease-out,background .2s ease-out;
+  }
+  .btn:hover{background:#2C3340}
+  .btn:active{transform:scale(.97)}
+  @keyframes rise{to{opacity:1;transform:translateY(0)}}
+  @keyframes draw{to{stroke-dashoffset:0}}
+  @media (prefers-reduced-motion:reduce){
+    .card{animation:none;opacity:1;transform:none}
+    .check{animation:none;stroke-dashoffset:0}
+    .btn{transition:none}
+  }
+</style>
+</head>
+<body>
+  <main class="card">
+    <div class="badge" aria-hidden="true">
+      <svg viewBox="0 0 24 24"><path class="check" d="M5 13l4 4L19 7"/></svg>
+    </div>
+    <h1>绑定成功 · 已连接 ${BRAND.name}</h1>
+    <p>可以关闭此页面，回到命令行</p>
+    <a class="btn" href="${BRAND.siteUrl}/src/pages/user-profile/index.html#tab=agents">去我的主页</a>
+  </main>
+</body>
+</html>`;
+
+const CALLBACK_HTML_ERROR = `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+<title>授权未完成 · ${BRAND.name}</title>
+<style>
+  *{margin:0;padding:0;box-sizing:border-box}
+  html,body{height:100%}
+  body{
+    font-family:-apple-system,BlinkMacSystemFont,"SF Pro Display","SF Pro Text","Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei",system-ui,sans-serif;
+    background:#F5F6F8;color:#0F1419;
+    display:flex;align-items:center;justify-content:center;
+    min-height:100vh;min-height:100dvh;
+    padding:24px;line-height:1.6;-webkit-font-smoothing:antialiased;
+  }
+  .card{
+    width:100%;max-width:380px;text-align:center;padding:8px;
+    opacity:0;transform:translateY(10px);
+    animation:rise .6s cubic-bezier(.16,1,.3,1) .05s forwards;
+  }
+  .badge{
+    width:72px;height:72px;border-radius:999px;margin:0 auto 32px;
+    display:flex;align-items:center;justify-content:center;
+    background:rgba(15,20,25,.05);
+  }
+  .badge svg{width:32px;height:32px}
+  .mark{fill:none;stroke:#0F1419;stroke-width:2.2;stroke-linecap:round;opacity:.55}
+  h1{font-size:21px;font-weight:500;letter-spacing:.02em;margin-bottom:12px}
+  p{font-size:14px;color:#4B5563;letter-spacing:.02em}
+  @keyframes rise{to{opacity:1;transform:translateY(0)}}
+  @media (prefers-reduced-motion:reduce){.card{animation:none;opacity:1;transform:none}}
+</style>
+</head>
+<body>
+  <main class="card">
+    <div class="badge" aria-hidden="true">
+      <svg viewBox="0 0 24 24">
+        <line class="mark" x1="12" y1="7" x2="12" y2="13"/>
+        <line class="mark" x1="12" y1="17" x2="12" y2="17"/>
+      </svg>
+    </div>
+    <h1>授权未完成</h1>
+    <p>可以关闭此页面，回到命令行重试</p>
+  </main>
+</body>
+</html>`;
+
+const CALLBACK_HTML_MISSING = `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+<title>回调异常 · ${BRAND.name}</title>
+<style>
+  *{margin:0;padding:0;box-sizing:border-box}
+  html,body{height:100%}
+  body{
+    font-family:-apple-system,BlinkMacSystemFont,"SF Pro Display","SF Pro Text","Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei",system-ui,sans-serif;
+    background:#F5F6F8;color:#0F1419;
+    display:flex;align-items:center;justify-content:center;
+    min-height:100vh;min-height:100dvh;
+    padding:24px;line-height:1.6;-webkit-font-smoothing:antialiased;
+  }
+  .card{
+    width:100%;max-width:380px;text-align:center;padding:8px;
+    opacity:0;transform:translateY(10px);
+    animation:rise .6s cubic-bezier(.16,1,.3,1) .05s forwards;
+  }
+  .badge{
+    width:72px;height:72px;border-radius:999px;margin:0 auto 32px;
+    display:flex;align-items:center;justify-content:center;
+    background:rgba(15,20,25,.05);
+  }
+  .badge svg{width:30px;height:30px}
+  .mark{fill:none;stroke:#0F1419;stroke-width:2.2;stroke-linecap:round;stroke-linejoin:round;opacity:.55}
+  h1{font-size:21px;font-weight:500;letter-spacing:.02em;margin-bottom:12px}
+  p{font-size:14px;color:#4B5563;letter-spacing:.02em}
+  @keyframes rise{to{opacity:1;transform:translateY(0)}}
+  @media (prefers-reduced-motion:reduce){.card{animation:none;opacity:1;transform:none}}
+</style>
+</head>
+<body>
+  <main class="card">
+    <div class="badge" aria-hidden="true">
+      <svg viewBox="0 0 24 24">
+        <path class="mark" d="M9.2 9.2a2.8 2.8 0 1 1 4.3 2.6c-.9.6-1.5 1.1-1.5 2.2"/>
+        <line class="mark" x1="12" y1="17.5" x2="12" y2="17.5"/>
+      </svg>
+    </div>
+    <h1>回调异常，缺少授权码</h1>
+    <p>可以关闭此页面</p>
+  </main>
+</body>
+</html>`;
+
+export { CALLBACK_HTML_SUCCESS, CALLBACK_HTML_ERROR, CALLBACK_HTML_MISSING };