@geoly-ai/social-hub-cli 0.3.18 → 0.3.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/dist/cmd-manifest.json +4 -2
  3. package/dist/content-review.test.js +1 -1
  4. package/dist/index.d.ts +24 -0
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +98 -8
  7. package/dist/index.js.map +1 -1
  8. package/dist/register-calendar-directives.d.ts +64 -0
  9. package/dist/register-calendar-directives.d.ts.map +1 -0
  10. package/dist/register-calendar-directives.js +135 -0
  11. package/dist/register-calendar-directives.js.map +1 -0
  12. package/dist/register-calendar-directives.test.d.ts +2 -0
  13. package/dist/register-calendar-directives.test.d.ts.map +1 -0
  14. package/dist/register-calendar-directives.test.js +127 -0
  15. package/dist/register-calendar-directives.test.js.map +1 -0
  16. package/dist/scrape-output.test.d.ts +2 -0
  17. package/dist/scrape-output.test.d.ts.map +1 -0
  18. package/dist/scrape-output.test.js +58 -0
  19. package/dist/scrape-output.test.js.map +1 -0
  20. package/package.json +2 -2
  21. package/skills/README.md +23 -22
  22. package/skills/manifest.json +6 -1
  23. package/skills/reddit-content-rewrite/SKILL.md +29 -0
  24. package/skills/reddit-content-writing/SKILL.md +54 -5
  25. package/skills/reddit-content-writing/references/phase4-execution-table.md +24 -3
  26. package/skills/reddit-content-writing/references/phase4-writing.md +123 -3
  27. package/skills/reddit-content-writing/references/post-writing-templates.md +14 -6
  28. package/skills/reddit-delivery-check/SKILL.md +39 -6
  29. package/skills/reddit-delivery-check/references/phase5-delivery.md +7 -1
  30. package/skills/reddit-matrix.lock.json +10 -10
  31. package/skills/reddit-phase-brief/SKILL.md +62 -11
  32. package/skills/reddit-phase-brief/references/brand-SKU-PGC-rules.md +223 -36
  33. package/skills/reddit-phase-brief/references/phase4-brief-workflow.md +405 -19
  34. package/skills/reddit-phase-planning/SKILL.md +13 -0
  35. package/skills/reddit-phase-planning/references/phase4-execution-table.md +16 -2
  36. package/skills/reddit-phase-planning/references/phase4-planning.md +74 -15
  37. package/skills/reddit-phase-planning/references/scheduling-decision-procedure.md +386 -0
  38. package/skills/reddit-phase-research/SKILL.md +7 -1
  39. package/skills/reddit-phase-research/references/phase01-research.md +93 -29
  40. package/skills/reddit-strategy-orchestrator/SKILL.md +120 -18
  41. package/skills/reddit-strategy-shared/SKILL.md +4 -2
  42. package/skills/reddit-strategy-shared/references/content-diversity-contract.md +26 -5
  43. package/skills/reddit-strategy-shared/references/content-review-gate.md +48 -1
  44. package/skills/reddit-strategy-shared/references/context-contract.md +45 -11
  45. package/skills/reddit-strategy-shared/references/evidence-policy.md +139 -0
  46. package/skills/reddit-strategy-shared/references/handoff-schemas.md +88 -3
  47. package/skills/reddit-strategy-shared/references/native-copy-profile.md +207 -0
  48. package/skills/reddit-strategy-shared/references/path-conventions.md +26 -4
  49. package/skills/reddit-strategy-shared/references/persona-card-contract.md +210 -0
  50. package/skills/reddit-strategy-shared/references/prerequisites/README.md +57 -0
  51. package/skills/reddit-strategy-shared/references/prerequisites/{reddit-master-canvas-agent-prompt-template.md → archive/reddit-master-canvas-agent-prompt-template.md} +7 -0
  52. package/skills/reddit-strategy-shared/references/prerequisites/{reddit-sop-v2-universal.md → archive/reddit-sop-v2-universal.md} +7 -0
  53. package/skills/reddit-strategy-shared/references/prerequisites/{reddit-strategy-prerequisites-read.md → archive/reddit-strategy-prerequisites-read.md} +7 -0
  54. package/skills/reddit-strategy-shared/references/prerequisites/{reddit-strategy-reuse-playbook.md → archive/reddit-strategy-reuse-playbook.md} +7 -0
  55. package/skills/reddit-strategy-shared/references/subreddit-research-profile.md +514 -0
  56. package/skills/reddit-strategy-shared/references/version-manifest.md +89 -2
  57. package/skills/reddit-subreddit-compliance/SKILL.md +28 -1
  58. package/skills/reddit-voc-volume/matrix-contract.md +16 -1
  59. package/skills/social-hub-calendar-directives/SKILL.md +548 -0
  60. package/skills/social-hub-calendar-jobs/SKILL.md +10 -0
  61. package/skills/social-hub-cli/SKILL.md +2 -0
  62. package/skills/social-hub-notifications/SKILL.md +7 -0
  63. package/skills/social-hub-publishing/SKILL.md +5 -0
@@ -21,6 +21,16 @@ social-hub calendar list-full -t <team-id> --account <accountId> --status schedu
21
21
  social-hub calendar patch -t <team-id> -e <entryId> --body '{"status":"succeeded","permalink":"..."}'
22
22
  ```
23
23
 
24
+ > **`deliveryMode` 决定这条条目由谁发布,改它必须带 `--apply`。**
25
+ > `hub_managed`(默认)= Hub 内部 job 发;`external_agent` = 广播指令给你自己机器上的
26
+ > agent 去建 cron 发。两者互斥,这是防重复发帖的唯一闸门 —— 切错就是双发或谁都不发。
27
+ > 切换入口与整套外部 agent 协议(`calendar preflight`、revision 状态机、UTC 一次性 cron)
28
+ > 见 [`../social-hub-calendar-directives/SKILL.md`](../social-hub-calendar-directives/SKILL.md)。
29
+ >
30
+ > ```bash
31
+ > social-hub calendar set-delivery-mode -t <team-id> -e <entryId> --mode external_agent --apply
32
+ > ```
33
+
24
34
  ## 调度任务
25
35
 
26
36
  ```bash
@@ -52,6 +52,8 @@ social-hub version --json
52
52
  | 运营板块池 catalog / aliases / tier rules | `social-hub-subreddit-pools` |
53
53
  | 通用网页抓取 / Firecrawl / scrape | `social-hub-scrape` |
54
54
  | 导入导出 / runbook / openclaw-ingest | `social-hub-migration` |
55
+ | 事件订阅通知(notify pull/ack/订阅) | `social-hub-notifications` |
56
+ | 日历指令:本地 agent 建 cron 定时发帖 / preflight | `social-hub-calendar-directives` |
55
57
 
56
58
  命中上表场景时,**打开对应领域 skill**;不要在总路由里重复展开领域命令细节。
57
59
 
@@ -30,6 +30,13 @@ Hub 在某个节点**发出一条事件**,你的 agent 通过 HTTP long-poll
30
30
 
31
31
  **别把 ack 当执行回执。** ack 唯一的作用是推进游标。
32
32
 
33
+ > **`publishing-calendar-directive.v1` 有一套额外的消费协议**,本 skill 的通用机制
34
+ > (游标 / receipt / dedupeKey / tombstone / 退出码)全部适用,但它多出:revision 状态机、
35
+ > 「事件身份 ≠ cron 身份」、到点必须过 preflight,以及 **ack 时机的局部改写**
36
+ > (副作用是「把指令应用到本地 cron/state」,cron 落盘即 ack;等到真的发帖才 ack 会把
37
+ > 后续 cancel 堵在连续 watermark 后面)。订阅这个 source 前先读
38
+ > [`../social-hub-calendar-directives/SKILL.md`](../social-hub-calendar-directives/SKILL.md)。
39
+
33
40
  ## 五个必须先内化的概念
34
41
 
35
42
  1. **游标是连续 watermark**:`cursorSeq = N` 表示该订阅**所有匹配事件**中 `seq ≤ N` 的
@@ -74,6 +74,11 @@ social-hub plans cancel -t <team-id> --plan <uuid> # 破坏性:先 list
74
74
 
75
75
  调度列表与 patch 见 **`social-hub-calendar-jobs`**(本 skill 不重复展开 jobs 全量命令)。
76
76
 
77
+ 条目上的 `deliveryMode` 决定谁来发:默认 `hub_managed`(Hub 建内部 job 自己发),
78
+ `external_agent` 则改由**用户自己机器上的 agent** 收指令建 cron 发。建计划时就能指定
79
+ (`entries[].deliveryMode`),比事后切干净。外部 agent 那条链路见
80
+ **`social-hub-calendar-directives`**。
81
+
77
82
  ## Agent 执行与回填
78
83
 
79
84
  优先 **`social-hub-ops-runtime`**:`ops claim-next` → `ops complete --permalink ...`。