@geoly-ai/social-hub-cli 0.0.2 → 0.0.4

package/dist/skills/tui.js

@@ -0,0 +1,140 @@
+import * as readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { listAgents } from "./agent-targets.js";
+import { buildInstallPlan, summarizePlan } from "./install-planner.js";
+import { executePlan } from "./installer.js";
+import { resolveBundledSource } from "./source-resolver.js";
+import { resolveAgentDefaultTarget } from "./target-detector.js";
+function isInteractive() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+async function promptSelect(rl, title, choices, multi = false) {
+    console.log(`\n${title}`);
+    choices.forEach((c, i) => console.log(`  ${i + 1}. ${c.label}`));
+    if (multi) {
+        console.log("  Enter numbers comma-separated (e.g. 1,3) or * for all:");
+    }
+    else {
+        console.log("  Enter number:");
+    }
+    const answer = (await rl.question("> ")).trim();
+    if (multi && answer === "*") {
+        return choices.map((c) => c.value);
+    }
+    const indices = answer.split(",").map((s) => Number.parseInt(s.trim(), 10) - 1);
+    if (multi) {
+        return indices
+            .filter((i) => i >= 0 && i < choices.length)
+            .map((i) => choices[i].value);
+    }
+    const idx = indices[0];
+    if (idx === undefined || idx < 0 || idx >= choices.length) {
+        throw new Error("Invalid selection");
+    }
+    return [choices[idx].value];
+}
+export function printNonInteractiveHint() {
+    console.log("Non-interactive environment detected. Use:");
+    console.log("  npx @geoly-ai/social-hub-cli skills install --agent cursor --global --yes");
+    console.log("  npx @geoly-ai/social-hub-cli skills update --all --yes");
+    console.log("  social-hub skills install --agent claude-code --project --yes");
+}
+export async function runSkillsTui(opts = {}) {
+    if (!isInteractive()) {
+        printNonInteractiveHint();
+        process.exit(1);
+    }
+    const rl = readline.createInterface({ input, output });
+    try {
+        const agents = listAgents();
+        const agentChoices = [
+            ...agents.map((a) => ({ label: a.label, value: a.id })),
+            { label: "Custom directory", value: "__custom__" },
+        ];
+        const selectedAgents = await promptSelect(rl, "Select target agent(s):", agentChoices, true);
+        let scope = opts.defaultScope ?? "project";
+        const scopeAns = (await rl.question("Scope [project/global] (default project): ")).trim();
+        if (scopeAns === "global")
+            scope = "global";
+        let installMode = "standalone";
+        if (selectedAgents.includes("claude-code")) {
+            const modeAns = (await rl.question("Claude install mode [standalone/plugin] (default standalone): ")).trim();
+            if (modeAns === "plugin")
+                installMode = "plugin";
+        }
+        const source = resolveBundledSource();
+        const skillChoices = source.manifest.skills.map((s) => ({
+            label: `${s.id} — ${s.description}`,
+            value: s.id,
+        }));
+        skillChoices.unshift({ label: "All social-hub skills", value: "*" });
+        const selectedSkills = await promptSelect(rl, "Select skill(s):", skillChoices, true);
+        const actionChoices = [
+            { label: "Install missing skills", value: "install" },
+            { label: "Update installed skills", value: "update" },
+            { label: "Reinstall selected skills", value: "reinstall" },
+        ];
+        const [actionRaw] = await promptSelect(rl, "Action:", actionChoices, false);
+        const action = actionRaw;
+        const methodAns = (await rl.question("Method [copy/symlink] (default copy): ")).trim();
+        const method = methodAns === "symlink" ? "symlink" : "copy";
+        const targets = [];
+        if (selectedAgents.includes("__custom__")) {
+            const dir = (await rl.question("Custom skills directory: ")).trim();
+            targets.push({
+                agentId: "custom",
+                label: "Custom",
+                dir,
+                scope,
+                installMode,
+            });
+        }
+        else {
+            for (const agentId of selectedAgents.filter((a) => a !== "__custom__")) {
+                targets.push(resolveAgentDefaultTarget(agentId, scope, opts.cwd));
+                if (installMode === "plugin" && agentId === "claude-code") {
+                    targets[targets.length - 1].installMode = "plugin";
+                }
+            }
+        }
+        const plan = buildInstallPlan({
+            action,
+            source,
+            targets,
+            skillIds: selectedSkills.includes("*") ? ["*"] : selectedSkills,
+            method,
+            force: action === "reinstall",
+        });
+        const summary = summarizePlan(plan);
+        console.log("\nPlan:");
+        console.log(JSON.stringify({ summary, items: plan.items, skipped: plan.skipped }, null, 2));
+        if (plan.items.length === 0) {
+            console.log("Nothing to do.");
+            return;
+        }
+        const confirm = (await rl.question("Proceed? [y/N]: ")).trim().toLowerCase();
+        if (confirm !== "y" && confirm !== "yes") {
+            console.log("Cancelled.");
+            return;
+        }
+        const result = executePlan(plan);
+        console.log(`Applied ${result.applied.length} item(s).`);
+        if (result.errors.length) {
+            for (const err of result.errors) {
+                console.error(`${err.item.skillId}: ${err.error}`);
+            }
+            process.exit(1);
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function runSkillsBootstrap(opts = {}) {
+    if (isInteractive()) {
+        await runSkillsTui(opts);
+        return;
+    }
+    printNonInteractiveHint();
+}
+//# sourceMappingURL=tui.js.map

package/dist/skills/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../src/skills/tui.ts"],"names":[],"mappings":"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"}

package/dist/skills/types.d.ts

@@ -0,0 +1,94 @@
+export type InstallScope = "global" | "project";
+export type InstallMethod = "copy" | "symlink";
+export type InstallMode = "standalone" | "plugin";
+export type PlanAction = "install" | "update" | "remove" | "reinstall";
+export type SkillManifestEntry = {
+    id: string;
+    path: string;
+    description: string;
+};
+export type SkillsManifest = {
+    version: number;
+    package: string;
+    cliVersion: string;
+    repository: string;
+    skills: SkillManifestEntry[];
+};
+export type ResolvedSkill = {
+    id: string;
+    path: string;
+    description: string;
+    skillDir: string;
+    skillMdPath: string;
+    skillVersion?: string;
+    cliVersion?: string;
+};
+export type SkillSourceKind = "bundled" | "local" | "github" | "skillsh";
+export type SkillSource = {
+    kind: SkillSourceKind;
+    ref: string;
+    version: string;
+    skillsRoot: string;
+    manifest: SkillsManifest;
+    digest?: string;
+    remote?: {
+        repo: string;
+        ref: string;
+        skillsPath: string;
+        cachedAt?: string;
+        cacheDir?: string;
+    };
+};
+export type AgentTarget = {
+    id: string;
+    label: string;
+    aliases?: string[];
+    projectPaths: string[];
+    globalPaths: string[];
+    marketplaceModes?: InstallMode[];
+};
+export type InstallTarget = {
+    agentId: string;
+    label: string;
+    dir: string;
+    scope: InstallScope;
+    installMode: InstallMode;
+};
+export type InstalledSkillRecord = {
+    id: string;
+    skillVersion: string;
+    checksum: string;
+    targetAgent: string;
+    targetDir: string;
+    installMode: InstallMode;
+    installedFiles: string[];
+    updatedAt: string;
+};
+export type SkillsState = {
+    source: string;
+    package: string;
+    version: string;
+    sourceDigest?: string;
+    installedAt: string;
+    updatedAt: string;
+    skills: InstalledSkillRecord[];
+};
+export type PlanItem = {
+    action: PlanAction;
+    skillId: string;
+    target: InstallTarget;
+    fromDir: string;
+    toDir: string;
+    method: InstallMethod;
+    overwrite: boolean;
+};
+export type InstallPlan = {
+    source: SkillSource;
+    items: PlanItem[];
+    skipped: {
+        skillId: string;
+        targetDir: string;
+        reason: string;
+    }[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"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"}

package/dist/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":""}

package/dist/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AA8BA,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAavE;AA0DD,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBpF"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AA+BA,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAavE;AA8DD,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBpF"}

package/dist/update-check.js

@@ -1,6 +1,7 @@
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
+import { isRunningViaNpx } from "./skills/paths.js";
 import { getCliVersion } from "./version-info.js";
 const PACKAGE_NAME = "@geoly-ai/social-hub-cli";
 const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME.replace("/", "%2F")}/latest`;
@@ -81,10 +82,14 @@ async function fetchLatestVersion() {
     }
 }
 function printUpdateNotice(current, latest) {
+    const upgradeLine = isRunningViaNpx()
+        ? `Run npx ${PACKAGE_NAME}@${latest} … to upgrade`
+        : `Run npm update -g ${PACKAGE_NAME} to upgrade`;
     process.stderr.write([
         "",
         `Update available ${current} → ${latest}`,
-        `Run npm update -g ${PACKAGE_NAME} to upgrade`,
+        upgradeLine,
+        `After upgrading CLI, run: social-hub skills update --yes`,
         "",
     ].join("\n"));
 }

package/dist/update-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geoly-ai/social-hub-cli",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "description": "social-hub CLI for Social Ops Hub",
   "repository": {
@@ -12,15 +12,16 @@
     "access": "public"
   },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "bin": {
     "social-hub": "./dist/index.js"
   },
   "dependencies": {
     "commander": "^12.1.0",
-    "@geoly-ai/social-hub-sdk": "0.0.2",
-    "@geoly-ai/social-hub-authz": "0.0.2"
+    "@geoly-ai/social-hub-authz": "0.0.3",
+    "@geoly-ai/social-hub-sdk": "0.0.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
@@ -28,7 +29,8 @@
     "vitest": "^2.1.8"
   },
   "scripts": {
-    "build": "tsc",
+    "copy-skills": "node ../../scripts/copy-skills-to-cli.mjs",
+    "build": "pnpm run copy-skills && tsc",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"
   }

package/skills/README.md

@@ -0,0 +1,113 @@
+# Social Hub Agent Skills
+
+本目录与 `@geoly-ai/social-hub-cli`、SDK、`@social-ops-hub/contracts` 同仓发布。Agent 通过 **`social-hub` CLI** 读写 Hub；Skill 只描述何时用哪条命令、权限与流程。
+
+### Skills 来源
+
+| 来源 | 命令 | 说明 |
+|------|------|------|
+| **bundled（默认）** | `social-hub skills install …` | npm 包内置，离线可用，与 CLI 版本对齐 |
+| **GitHub** | `--source github --repo geoly-ai/geoly-reddit [--ref main]` | 从 GitHub 拉取 `social-ops-hub/skills`，缓存 24h |
+| **skill.sh** | `--source skillsh --repo owner/name` | 与 GitHub 相同拉取逻辑（skill.sh 导入仓库） |
+| **local** | `--source local --local-path ./skills` | 本地目录 |
+
+```bash
+# 从 GitHub 安装最新 skill（缓存 ~/.cache/social-hub/skills/github/…）
+social-hub skills install --source github --agent cursor --global --yes
+
+# 强制刷新 GitHub 缓存
+social-hub skills update --source github --refresh --yes
+
+# 清除缓存
+social-hub skills cache clear
+```
+
+环境变量：`SOCIAL_HUB_SKILLS_REPO`、`SOCIAL_HUB_SKILLS_REF`、`SOCIAL_HUB_SKILLS_PATH`、`GITHUB_TOKEN`（**私有仓库必填**）
+
+默认仓库 `geoly-ai/geoly-reddit` 若为私有，需先 `export GITHUB_TOKEN=ghp_...` 再执行 `--source github`。
+
+## 安装 Agent Skills（推荐 CLI）
+
+Skills 随 `@geoly-ai/social-hub-cli` 一起发布（npm tarball 内置 `skills/`）。
+
+```bash
+# 交互式（选 agent、skill、install/update）
+social-hub skills tui
+
+# 或脚本化
+social-hub skills install --agent cursor --global --yes
+social-hub skills install --agent claude-code --project --yes
+social-hub skills install --agent codex --global --all --yes
+
+# 更新到当前 CLI 内置版本
+social-hub skills update --all --yes
+
+# 健康检查
+social-hub skills doctor --json
+
+# 无需全局安装
+npx @geoly-ai/social-hub-cli skills bootstrap
+pnpm dlx @geoly-ai/social-hub-cli skills list
+```
+
+支持 [skill.sh](https://skill.sh) 兼容的全部 agent（`social-hub skills list --agents`）。安装状态记录在目标目录下的 `.social-hub-skills.json`。
+
+## 发布到 skill 市场（skill.sh / Agent Skill Hub）
+
+1. 将本仓库推送到 GitHub（`skills/` 保持在仓库内）。
+2. 在 [skill.sh](https://skill.sh) 或 Agent Skill Hub 添加仓库 URL，选择要导入的 skill 目录（如 `skills/social-hub-cli`）。
+3. 用户安装示例（以市场 CLI 为准，名称可能为 `skill`、`skhub` 等）：
+
+```bash
+# 示例：从 registry 安装（具体命令以 skill.sh 文档为准）
+skill add <org>/social-ops-hub/social-hub-cli
+skill add <org>/social-ops-hub/social-hub-ops-runtime
+```
+
+每个 skill 为独立目录，内含 `SKILL.md`（YAML frontmatter 含 `name`、`description`）。
+
+## 本地开发安装（任意 IDE）
+
+| 方式 | 说明 |
+|------|------|
+| **CLI（推荐）** | `social-hub skills install --agent cursor` 或 `social-hub skills tui` |
+| **npx** | `npx @geoly-ai/social-hub-cli skills bootstrap` |
+| **项目内脚本** | `pnpm skills:install` → 默认 `.agents/skills/` |
+| **指定目录** | `SKILLS_INSTALL_DIR=~/.cursor/skills pnpm skills:install` |
+| **符号链接** | `social-hub skills install --symlink --dir <path>` |
+
+```bash
+# 默认：复制到 social-ops-hub/.agents/skills/
+pnpm skills:install
+
+# 安装到自定义目录（Cursor / Codex / Claude Code / 其他）
+SKILLS_INSTALL_DIR="$HOME/.config/your-agent/skills" pnpm skills:install
+
+# 校验 frontmatter 与 manifest
+pnpm skills:check
+```
+
+安装后**重启或重新加载**当前 IDE/Agent 的 skill 列表（各产品入口不同）。
+
+## Skill 列表
+
+| Skill | 用途 |
+|-------|------|
+| [social-hub-cli](social-hub-cli) | 总路由 + 命令速查 |
+| [social-hub-shared](social-hub-shared) | config、auth、doctor、context |
+| [social-hub-ops-runtime](social-hub-ops-runtime) | claim / complete / fail |
+| [social-hub-openclaw-context](social-hub-openclaw-context) | DB 聚合上下文 |
+| [social-hub-accounts](social-hub-accounts) | 账号 |
+| [social-hub-posts](social-hub-posts) | Reddit 帖 |
+| [social-hub-calendar-jobs](social-hub-calendar-jobs) | 日历与任务 |
+| [social-hub-publishing](social-hub-publishing) | 发布闭环 |
+| [social-hub-admin](social-hub-admin) | 系统/团队管理 |
+| [social-hub-intelligence](social-hub-intelligence) | 板块情报 |
+| [social-hub-migration](social-hub-migration) | 导入导出与 replay |
+
+清单见 [manifest.json](manifest.json)。与 API/CLI 对齐情况见仓库 `docs/cli-api-coverage.md`。
+
+## 版本
+
+- CLI / SDK / contracts 与 skills 使用同一 git tag 发布。
+- 各 `SKILL.md` 的 `metadata` 可声明 `cliVersion: ">=0.0.1"`（见 frontmatter）。

package/skills/manifest.json

@@ -0,0 +1,68 @@
+{
+  "version": 1,
+  "package": "social-ops-hub",
+  "cliVersion": "0.0.4",
+  "repository": "social-ops-hub",
+  "publish": {
+    "registry": "https://skill.sh",
+    "layout": "skills/<skill-id>/SKILL.md",
+    "note": "Import this GitHub repo on skill.sh; select skill subdirectories under skills/"
+  },
+  "skills": [
+    {
+      "id": "social-hub-cli",
+      "path": "social-hub-cli",
+      "description": "总路由：Hub CLI 触发词与领域 Skill 索引"
+    },
+    {
+      "id": "social-hub-shared",
+      "path": "social-hub-shared",
+      "description": "config、auth、doctor、permissions、context"
+    },
+    {
+      "id": "social-hub-ops-runtime",
+      "path": "social-hub-ops-runtime",
+      "description": "OpenClaw 任务 claim、heartbeat、complete、fail、skip"
+    },
+    {
+      "id": "social-hub-openclaw-context",
+      "path": "social-hub-openclaw-context",
+      "description": "DB-first 账号/任务上下文与板块候选"
+    },
+    {
+      "id": "social-hub-accounts",
+      "path": "social-hub-accounts",
+      "description": "账号 CRUD、品牌绑定、状态快照"
+    },
+    {
+      "id": "social-hub-posts",
+      "path": "social-hub-posts",
+      "description": "Reddit 帖快照、刷新、统计"
+    },
+    {
+      "id": "social-hub-calendar-jobs",
+      "path": "social-hub-calendar-jobs",
+      "description": "日历、调度任务、retry/cancel"
+    },
+    {
+      "id": "social-hub-publishing",
+      "path": "social-hub-publishing",
+      "description": "campaign 到 report 发布闭环"
+    },
+    {
+      "id": "social-hub-admin",
+      "path": "social-hub-admin",
+      "description": "settings、invites、members、api-keys"
+    },
+    {
+      "id": "social-hub-intelligence",
+      "path": "social-hub-intelligence",
+      "description": "板块情报 watchlists、hot posts、industry pools"
+    },
+    {
+      "id": "social-hub-migration",
+      "path": "social-hub-migration",
+      "description": "JSONL 导入导出、runbook replay"
+    }
+  ]
+}

package/skills/social-hub-accounts/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: social-hub-accounts
+description: >-
+  Social Hub 社交账号：social-hub accounts list/get/create/update/delete、brand-bindings、status-snapshots。
+  用户要查 Reddit 账号、改 handle、绑品牌、看账号状态快照、同步飞书账号字段时用本 skill。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-accounts
+
+```bash
+social-hub accounts list -t "$T" -n 50
+social-hub accounts get -t "$T" --id "<uuid>"
+social-hub accounts update -t "$T" --id "<uuid>" -j '{"workflowStage":"active",...}'
+social-hub accounts delete -t "$T" --id "<uuid>"    # 危险：需确认
+
+social-hub accounts brand-bindings list -t "$T" --account "<uuid>"
+social-hub accounts brand-bindings add -t "$T" --account "<uuid>" -j '{"brandId":"..."}'
+social-hub accounts brand-bindings remove -t "$T" --account "<uuid>" --brand "<brandId>"
+
+social-hub accounts status-snapshots list -t "$T" --account "<uuid>"
+```
+
+OpenClaw 执行前优先 `social-hub context account`（见 `social-hub-openclaw-context`），不要只读本地 `account-profiles/*.md`。

package/skills/social-hub-admin/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: social-hub-admin
+description: >-
+  Social Hub 管理面：settings、invites、members、api-keys、agent-teams、users。
+  用户要改系统设置、发团队邀请、列成员、轮换 API Key 时用本 skill；高风险写操作需 --apply。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-admin
+
+## Settings（admin）
+
+```bash
+social-hub settings list
+social-hub settings get <key>
+social-hub settings set <key> --value "..." --dry-run
+social-hub settings set <key> --value "..." --apply
+```
+
+## Invites
+
+```bash
+social-hub invites list -t "$T"
+social-hub invites create -t "$T" --email user@example.com --role manager --dry-run
+social-hub invites create -t "$T" --email user@example.com --role manager --apply
+social-hub invites revoke -t "$T" --id "<inviteId>" --apply
+```
+
+## Members
+
+```bash
+social-hub members list
+```
+
+API Keys、users、agent-teams 等见 `social-hub-cli` 管理章节。

package/skills/social-hub-calendar-jobs/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: social-hub-calendar-jobs
+description: >-
+  发布日历与调度任务：social-hub calendar list、jobs list/create/batch/retry/cancel。
+  用户要排期、查 scheduled job、重试失败任务、取消任务时用本 skill；Agent 执行态回填优先 ops-runtime。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-calendar-jobs
+
+```bash
+social-hub calendar list -t "$T"
+social-hub jobs list -t "$T" --status scheduled
+social-hub jobs create -t "$T" -j '{"socialAccountId":"...","subreddit":"...","runAt":"..."}'
+social-hub jobs retry -t "$T" --job "<id>"
+social-hub jobs cancel -t "$T" --job "<id>"
+```
+
+遗留：`jobs agent-status` 仍可更新状态，但 OpenClaw 推荐：
+
+```bash
+social-hub ops claim-next -t "$T" --agent "<agentId>"
+social-hub ops complete|fail|skip ...
+```