@geoly-ai/social-hub-core 0.0.4 → 0.0.6

package/dist/content-review-scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-review-scoring.d.ts","sourceRoot":"","sources":["../src/content-review-scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,yBAAyB,GACjC,mBAAmB,GACnB,YAAY,GACZ,SAAS,GACT,eAAe,GACf,YAAY,GACZ,iBAAiB,CAAC;AAEtB,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAC/C,yBAAyB,EACzB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CACpC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;IACnD,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,0BAA0B,EAAE,MAAM,CAAC;IACnC,0CAA0C;IAC1C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,wBAAwB,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD,eAAO,MAAM,6BAA6B,EAAE,mBAgB3C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,4BAA4B,CAAC;IACzC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,SAAS,EACL,sBAAsB,GACtB,6BAA6B,GAC7B,aAAa,GACb,cAAc,GACd,YAAY,CAAC;IACjB,iBAAiB,EAAE,8BAA8B,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B,EAAE,MAAM,CAAC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,sDAAsD;AACtD,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,mBAAmB,EAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,8BAA8B,CAYhC;AAED,gDAAgD;AAChD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,GAAG,SAAS,GACxD,mBAAmB,CAUrB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,wBAAwB,CAiE1B;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,qBAAqB,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAQF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,GACZ,0BAA0B,EAAE,CAS9B"}

package/dist/content-review-scoring.js

@@ -0,0 +1,128 @@
+/**
+ * 内容复审的服务端计分与 verdict 判定(纯函数,权威口径)。
+ *
+ * LLM 只产出六维原始分与证据;综合分由这里按版本化权重计算,verdict 由
+ * precedence 规则判定——防止模型自报综合分漂移/越权(独立模型换代后分布
+ * 变化不影响阈值语义)。策略可整体替换(system_settings 覆盖默认),每次
+ * 复审记录 thresholdSnapshot 供金丝雀跨版本对比。
+ */
+export const CONTENT_REVIEW_RUBRIC_VERSION = "v1";
+export const DEFAULT_CONTENT_REVIEW_POLICY = {
+    policyVersion: "v1",
+    weights: {
+        // 情境锚定权重最高(需求 §6):能原样贴到另外 50 个帖子下 = 不合格。
+        context_anchoring: 3,
+        burstiness: 1.5,
+        ai_tone: 2,
+        persona_voice: 1.5,
+        compliance: 1,
+        self_repetition: 1,
+    },
+    blockBelow: 55,
+    reviseBelow: 75,
+    contextAnchoringBlockBelow: 50,
+    complianceBlockBelow: 60,
+    quietStageThresholdBonus: 10,
+};
+/** 本次请求实际生效的策略快照(degraded/deterministic 分支也要完整留档)。 */
+export function getContentReviewThresholdSnapshot(policy, stage) {
+    const stageBonus = stage === "静默期" ? policy.quietStageThresholdBonus : 0;
+    return {
+        policyVersion: policy.policyVersion,
+        weights: policy.weights,
+        blockBelow: policy.blockBelow + stageBonus,
+        reviseBelow: policy.reviseBelow + stageBonus,
+        contextAnchoringBlockBelow: policy.contextAnchoringBlockBelow + stageBonus,
+        complianceBlockBelow: policy.complianceBlockBelow + stageBonus,
+        stageBonusApplied: stageBonus,
+        stage: stage ?? null,
+    };
+}
+/** system_settings 覆盖默认策略时的合并(部分覆盖,未给字段用默认)。 */
+export function mergeContentReviewPolicy(override) {
+    if (!override)
+        return DEFAULT_CONTENT_REVIEW_POLICY;
+    return {
+        ...DEFAULT_CONTENT_REVIEW_POLICY,
+        ...override,
+        weights: {
+            ...DEFAULT_CONTENT_REVIEW_POLICY.weights,
+            ...(override.weights ?? {}),
+        },
+    };
+}
+export function scoreContentReview(input) {
+    const policy = input.policy ?? DEFAULT_CONTENT_REVIEW_POLICY;
+    const stageBonus = input.stage === "静默期" ? policy.quietStageThresholdBonus : 0;
+    const blockBelow = policy.blockBelow + stageBonus;
+    const reviseBelow = policy.reviseBelow + stageBonus;
+    const anchorBlockBelow = policy.contextAnchoringBlockBelow + stageBonus;
+    const complianceBlockBelow = policy.complianceBlockBelow + stageBonus;
+    const clamp = (n) => Math.max(0, Math.min(100, n));
+    let weightSum = 0;
+    let weighted = 0;
+    for (const [key, weight] of Object.entries(policy.weights)) {
+        weightSum += weight;
+        weighted += clamp(input.dimensions[key].score) * weight;
+    }
+    const computedScore = Math.round(weighted / (weightSum || 1));
+    // 与 deterministic/degraded 分支共用同一 snapshot 结构。
+    const thresholdSnapshot = getContentReviewThresholdSnapshot(policy, input.stage);
+    // Precedence: 合规红线 > 情境锚定一票否决 > 综合分阈值。
+    if (clamp(input.dimensions.compliance.score) < complianceBlockBelow) {
+        return {
+            verdict: "block",
+            computedScore,
+            decidedBy: "compliance_hard_fail",
+            thresholdSnapshot,
+        };
+    }
+    if (clamp(input.dimensions.context_anchoring.score) < anchorBlockBelow) {
+        return {
+            verdict: "block",
+            computedScore,
+            decidedBy: "context_anchoring_hard_fail",
+            thresholdSnapshot,
+        };
+    }
+    if (computedScore < blockBelow) {
+        return {
+            verdict: "block",
+            computedScore,
+            decidedBy: "score_block",
+            thresholdSnapshot,
+        };
+    }
+    if (computedScore < reviseBelow) {
+        return {
+            verdict: "revise",
+            computedScore,
+            decidedBy: "score_revise",
+            thresholdSnapshot,
+        };
+    }
+    return {
+        verdict: "pass",
+        computedScore,
+        decidedBy: "score_pass",
+        thresholdSnapshot,
+    };
+}
+const URL_RE = /(https?:\/\/|www\.)[^\s)\]]+/i;
+const EMAIL_RE = /[\w.+-]+@[\w-]+\.[a-z]{2,}/i;
+// 站外联系引导:telegram/whatsapp/discord/dm me at 等
+const SOLICITATION_RE = /\b(telegram|whatsapp|wechat|discord\.gg|dm me (?:at|on)|contact me (?:at|on))\b/i;
+export function detectDeterministicComplianceHits(draft) {
+    const hits = [];
+    const url = draft.match(URL_RE);
+    if (url)
+        hits.push({ rule: "url", match: url[0] });
+    const email = draft.match(EMAIL_RE);
+    if (email)
+        hits.push({ rule: "email", match: email[0] });
+    const sol = draft.match(SOLICITATION_RE);
+    if (sol)
+        hits.push({ rule: "handle_solicitation", match: sol[0] });
+    return hits;
+}
+//# sourceMappingURL=content-review-scoring.js.map

package/dist/content-review-scoring.js.map

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

package/dist/content-review-scoring.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=content-review-scoring.test.d.ts.map

package/dist/content-review-scoring.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-review-scoring.test.d.ts","sourceRoot":"","sources":["../src/content-review-scoring.test.ts"],"names":[],"mappings":""}

package/dist/content-review-scoring.test.js

@@ -0,0 +1,109 @@
+import { describe, expect, it } from "vitest";
+import { DEFAULT_CONTENT_REVIEW_POLICY, detectDeterministicComplianceHits, scoreContentReview, } from "./content-review-scoring.js";
+function dims(over = {}) {
+    const base = {
+        context_anchoring: 85,
+        burstiness: 85,
+        ai_tone: 85,
+        persona_voice: 85,
+        compliance: 95,
+        self_repetition: 90,
+        ...over,
+    };
+    return Object.fromEntries(Object.entries(base).map(([k, score]) => [
+        k,
+        { score, issues: [] },
+    ]));
+}
+describe("scoreContentReview", () => {
+    it("passes a human-sounding contextual comment", () => {
+        const r = scoreContentReview({ dimensions: dims() });
+        expect(r.verdict).toBe("pass");
+        expect(r.decidedBy).toBe("score_pass");
+        expect(r.computedScore).toBeGreaterThanOrEqual(75);
+    });
+    it("blocks on compliance hard fail regardless of other scores", () => {
+        const r = scoreContentReview({ dimensions: dims({ compliance: 30 }) });
+        expect(r.verdict).toBe("block");
+        expect(r.decidedBy).toBe("compliance_hard_fail");
+    });
+    it("blocks on context anchoring hard fail (one-vote veto)", () => {
+        const r = scoreContentReview({
+            dimensions: dims({ context_anchoring: 40 }),
+        });
+        expect(r.verdict).toBe("block");
+        expect(r.decidedBy).toBe("context_anchoring_hard_fail");
+    });
+    it("revises mid-band scores", () => {
+        const r = scoreContentReview({
+            dimensions: dims({
+                ai_tone: 55,
+                burstiness: 60,
+                persona_voice: 60,
+                context_anchoring: 65,
+            }),
+        });
+        expect(r.verdict).toBe("revise");
+        expect(r.decidedBy).toBe("score_revise");
+    });
+    it("blocks low overall scores", () => {
+        const r = scoreContentReview({
+            dimensions: dims({
+                ai_tone: 30,
+                burstiness: 30,
+                persona_voice: 30,
+                context_anchoring: 55,
+                self_repetition: 40,
+            }),
+        });
+        expect(r.verdict).toBe("block");
+        expect(r.decidedBy).toBe("score_block");
+    });
+    it("tightens thresholds for 静默期 accounts", () => {
+        const borderline = dims({
+            context_anchoring: 76,
+            ai_tone: 76,
+            burstiness: 76,
+            persona_voice: 76,
+            compliance: 80,
+            self_repetition: 76,
+        });
+        const normal = scoreContentReview({
+            dimensions: borderline,
+            stage: "互动期",
+        });
+        const quiet = scoreContentReview({
+            dimensions: borderline,
+            stage: "静默期",
+        });
+        expect(normal.verdict).toBe("pass");
+        expect(quiet.verdict).toBe("revise");
+        expect(quiet.thresholdSnapshot.stageBonusApplied).toBe(DEFAULT_CONTENT_REVIEW_POLICY.quietStageThresholdBonus);
+    });
+    it("records the effective policy snapshot", () => {
+        const r = scoreContentReview({ dimensions: dims() });
+        expect(r.thresholdSnapshot.policyVersion).toBe("v1");
+        expect(r.thresholdSnapshot.blockBelow).toBe(55);
+    });
+    it("weights context anchoring heaviest", () => {
+        const anchorLow = scoreContentReview({
+            dimensions: dims({ context_anchoring: 55 }),
+        }).computedScore;
+        const toneLow = scoreContentReview({
+            dimensions: dims({ burstiness: 55 }),
+        }).computedScore;
+        expect(anchorLow).toBeLessThan(toneLow);
+    });
+});
+describe("detectDeterministicComplianceHits", () => {
+    it("flags urls, emails and off-platform solicitation", () => {
+        expect(detectDeterministicComplianceHits("check https://example.com/promo")).toEqual([{ rule: "url", match: "https://example.com/promo" }]);
+        expect(detectDeterministicComplianceHits("mail me sales@brand.com")).toEqual([{ rule: "email", match: "sales@brand.com" }]);
+        expect(detectDeterministicComplianceHits("dm me on telegram for a deal")[0]
+            ?.rule).toBe("handle_solicitation");
+    });
+    it("does not flag plain human comments", () => {
+        expect(detectDeterministicComplianceHits("ran the 9700x on a b650 board for 6 months, zero whea errors after the agesa update")).toEqual([]);
+    });
+});
+//# sourceMappingURL=content-review-scoring.test.js.map

package/dist/content-review-scoring.test.js.map

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

package/dist/errors.d.ts

@@ -11,5 +11,8 @@ export declare function tooManyRequests(message?: string): AppError;
 export declare function unauthorized(message?: string): AppError;
 export declare function forbidden(message?: string): AppError;
 export declare function notFound(message?: string): AppError;
+/** 语义上无法处理的请求(字段互相矛盾等),区别于 400 的"格式不对"。 */
+export declare function unprocessable(message?: string): AppError;
+export declare function conflict(message?: string, details?: unknown): AppError;
 export declare function internalError(message?: string): AppError;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;aAElB,OAAO,CAAC,EAAE,OAAO;gBAHjB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAE5E;AAED,wBAAgB,UAAU,CAAC,OAAO,SAAgB,GAAG,QAAQ,CAE5D;AAED,wBAAgB,eAAe,CAAC,OAAO,SAAsB,GAAG,QAAQ,CAEvE;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAiB,GAAG,QAAQ,CAE/D;AAED,wBAAgB,SAAS,CAAC,OAAO,SAAc,GAAG,QAAQ,CAEzD;AAED,wBAAgB,QAAQ,CAAC,OAAO,SAAc,GAAG,QAAQ,CAExD;AAED,wBAAgB,aAAa,CAAC,OAAO,SAAmB,GAAG,QAAQ,CAElE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;aAElB,OAAO,CAAC,EAAE,OAAO;gBAHjB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAE5E;AAED,wBAAgB,UAAU,CAAC,OAAO,SAAgB,GAAG,QAAQ,CAE5D;AAED,wBAAgB,eAAe,CAAC,OAAO,SAAsB,GAAG,QAAQ,CAEvE;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAiB,GAAG,QAAQ,CAE/D;AAED,wBAAgB,SAAS,CAAC,OAAO,SAAc,GAAG,QAAQ,CAEzD;AAED,wBAAgB,QAAQ,CAAC,OAAO,SAAc,GAAG,QAAQ,CAExD;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,OAAO,SAAyB,GAAG,QAAQ,CAExE;AAED,wBAAgB,QAAQ,CAAC,OAAO,SAAa,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAE1E;AAED,wBAAgB,aAAa,CAAC,OAAO,SAAmB,GAAG,QAAQ,CAElE"}

package/dist/errors.js

@@ -29,6 +29,13 @@ export function forbidden(message = "Forbidden") {
 export function notFound(message = "Not found") {
     return new AppError("NOT_FOUND", 404, message);
 }
+/** 语义上无法处理的请求(字段互相矛盾等),区别于 400 的"格式不对"。 */
+export function unprocessable(message = "Unprocessable entity") {
+    return new AppError("UNPROCESSABLE_ENTITY", 422, message);
+}
+export function conflict(message = "Conflict", details) {
+    return new AppError("CONFLICT", 409, message, details);
+}
 export function internalError(message = "Internal error") {
     return new AppError("INTERNAL_ERROR", 500, message);
 }

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEf;IACA;IAEA;IAJlB,YACkB,IAAY,EACZ,UAAkB,EAClC,OAAe,EACC,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAQ;QAElB,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,OAAiB;IAChE,OAAO,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAO,GAAG,aAAa;IAChD,OAAO,IAAI,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAO,GAAG,mBAAmB;IAC3D,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,cAAc;IACnD,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAO,GAAG,WAAW;IAC7C,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAO,GAAG,WAAW;IAC5C,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,gBAAgB;IACtD,OAAO,IAAI,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEf;IACA;IAEA;IAJlB,YACkB,IAAY,EACZ,UAAkB,EAClC,OAAe,EACC,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAQ;QAElB,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,OAAiB;IAChE,OAAO,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAO,GAAG,aAAa;IAChD,OAAO,IAAI,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAO,GAAG,mBAAmB;IAC3D,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,cAAc;IACnD,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAO,GAAG,WAAW;IAC7C,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAO,GAAG,WAAW;IAC5C,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,sBAAsB;IAC5D,OAAO,IAAI,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAO,GAAG,UAAU,EAAE,OAAiB;IAC9D,OAAO,IAAI,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,gBAAgB;IACtD,OAAO,IAAI,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/index.d.ts

@@ -3,4 +3,8 @@ export * from "./graph-domain.js";
 export * from "./errors.js";
 export * from "./reddit-topic-taxonomy.js";
 export * from "./openclaw-config.js";
+export * from "./client-delivery-config.js";
+export * from "./content-review-scoring.js";
+export * from "./activity.js";
+export * from "./notification-sources/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAG9B,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -3,4 +3,10 @@ export * from "./graph-domain.js";
 export * from "./errors.js";
 export * from "./reddit-topic-taxonomy.js";
 export * from "./openclaw-config.js";
+export * from "./client-delivery-config.js";
+export * from "./content-review-scoring.js";
+export * from "./activity.js";
+// 事件订阅通知能力：registry 是 db/worker/api 的暴露面推导单点，必须能跨包 import。
+// core 的 exports map 只有 "."，没有 subpath，故在此 re-export（零依赖纯 TS，不引 node:*）。
+export * from "./notification-sources/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,2DAA2D;AAC3D,yEAAyE;AACzE,cAAc,iCAAiC,CAAC"}

package/dist/notification-sources/field-paths.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 事件订阅通知能力 —— Block 0：字段路径原语（代码侧 source registry 的地基）。
+ *
+ * 为什么放 `packages/core` 而不是 contracts：
+ *   - 本文件是**纯 TS、零依赖**（core 没有 zod、没有 node:crypto），registry 框架要能被
+ *     db / worker / api 直接引用做「暴露面推导」，不该被 zod 绑架。
+ *   - contracts 侧（`packages/contracts/src/notifications.ts`）只负责 **wire 形状**（zod）。
+ *     两边各自 pin 同一份叶子路径清单，跨包一致性检查留给集成块（见设计文档 §12 验收点 A-38）。
+ *
+ * 铁律：字段路径是**开发者声明的 schema identifier**，不是用户输入。因此不做 trim /
+ * lowercase / NFKC 归一化——任何大小写或空白差异一律视为「未知字段」直接拒绝，
+ * 避免「后台保存的是 A、实际 hash 的是 B」。
+ */
+/**
+ * 受限字段路径语法：ASCII 点号叶子路径，segment 必须小写字母开头 + 字母数字。
+ * 明确**不**支持：转义、索引（`a.0.b`）、非 ASCII、空 segment。
+ * 数组整体即叶子（如 `trigger.supersededNodes`），永不产生索引路径。
+ */
+export declare const NOTIFICATION_FIELD_PATH_PATTERN: RegExp;
+export declare function isNotificationFieldPath(value: unknown): value is string;
+/**
+ * 字段路径排序 comparator。
+ *
+ * ⚠️ 规范冻结为「按 **ASCII 字节字典序** 升序」，而不是含糊的「JS 默认排序」——
+ * JS 的 `<` 比较严格说是 UTF-16 code unit 序，与 code point 序在 BMP 外不一致。
+ * 由于路径语法已限制为 ASCII，三者在本域内结果相同；显式写出来是为了让
+ * 其它语言/其它层（SQL、Go agent）能一字不差地复现 fieldSetVersion。
+ */
+export declare function compareNotificationFieldPaths(left: string, right: string): 0 | 1 | -1;
+/** 排序（不去重、不校验；调用方负责先 assert）。返回新数组。 */
+export declare function sortNotificationFieldPaths(paths: readonly string[]): readonly string[];
+/**
+ * 单条事件的触发形态（定义在本文件是为了让 {@link NotificationFieldDefinition.variants}
+ * 能强类型引用而不与 source-definition.ts 形成循环 import）。
+ *   - `scheduled_node`：正常到点。
+ *   - `catchup`：一次 overdue 折叠（多个错过的节点塌缩成一条，见设计文档 §7）。
+ */
+export declare const NOTIFICATION_TRIGGER_MODES: readonly ["scheduled_node", "catchup"];
+export type NotificationTriggerMode = (typeof NOTIFICATION_TRIGGER_MODES)[number];
+/** 字段敏感度。后台**永远不能**改这个值——它是代码侧声明的暴露面等级。 */
+export declare const NOTIFICATION_FIELD_SENSITIVITIES: readonly ["public", "internal", "restricted"];
+export type NotificationFieldSensitivity = (typeof NOTIFICATION_FIELD_SENSITIVITIES)[number];
+/**
+ * 字段值形态（供后台展示与 agent 解析用；不是 zod 类型，wire 校验在 contracts）。
+ * `stringArray` 是「数组整体作为叶子」的唯一合法形态。
+ */
+export declare const NOTIFICATION_FIELD_VALUE_KINDS: readonly ["string", "uuid", "url", "datetime", "integer", "ratio", "enum", "stringArray"];
+export type NotificationFieldValueKind = (typeof NOTIFICATION_FIELD_VALUE_KINDS)[number];
+/**
+ * 单条 authz 需求。语义**恒为 AND**（一个字段声明多条 = 全部满足才可选/可发）。
+ * 不允许 OR——OR 会让「谁能看到什么」在不同调用方被解释成不同结果。
+ */
+export interface NotificationFieldPermission {
+    readonly resource: string;
+    readonly action: "list" | "read";
+}
+/** 便于书写与日志展示的 `resource:action` 串。 */
+export declare function formatNotificationFieldPermission(permission: NotificationFieldPermission): string;
+/**
+ * 字段声明（代码侧唯一真源；改任何一项都必须 bump sourceDefinitionVersion，
+ * 改 `valueKind`/`nullable` 还必须 bump payloadSchemaVersion）。
+ */
+export interface NotificationFieldDefinition {
+    /** 叶子路径，必须匹配 {@link NOTIFICATION_FIELD_PATH_PATTERN}。 */
+    readonly path: string;
+    readonly sensitivity: NotificationFieldSensitivity;
+    readonly valueKind: NotificationFieldValueKind;
+    /**
+     * true = 字段被选中后即使数据不可得也**必定出现**、值为 `null`
+     *（区别于「未选中 → key 完全不出现」）。
+     * 这是「browserEnvironment 解析不到仍然发事件」的表达方式。
+     */
+    readonly nullable: boolean;
+    /** AND 语义；空数组 = 只要能读该 subscription 即可见。 */
+    readonly requiredPermissions: readonly NotificationFieldPermission[];
+    /**
+     * 字段依赖：选中本字段则**自动补入**这些字段（依赖闭包），
+     * 保证「有值但无法判断值的观测时间/来源」这类不可解释的暴露不会发生。
+     */
+    readonly requires?: readonly string[];
+    /**
+     * 仅对这些 trigger variant 有意义（省略 = **所有** variant）。
+     * catchup 专属字段（winnerScheduleId 等）用它标注，避免污染正常节点事件。
+     * 强类型 + registry 自检双重把关：拼错成 `"catcup"` 会让字段进了 configuredFields
+     * 却在所有 variant 事件里消失（静默丢字段），必须在声明期就炸掉。
+     */
+    readonly variants?: readonly NotificationTriggerMode[];
+    /** 后台展示用中文说明。 */
+    readonly description: string;
+}
+/** 建索引，供 O(1) 查找与未知路径拒绝。 */
+export declare function indexNotificationFields(fields: readonly NotificationFieldDefinition[]): ReadonlyMap<string, NotificationFieldDefinition>;
+//# sourceMappingURL=field-paths.d.ts.map

package/dist/notification-sources/field-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-paths.d.ts","sourceRoot":"","sources":["../../src/notification-sources/field-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,QACG,CAAC;AAEhD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAIvE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,cAExE;AAED,uCAAuC;AACvC,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,SAAS,MAAM,EAAE,CAEnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,wCAG7B,CAAC;AACX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,2CAA2C;AAC3C,eAAO,MAAM,gCAAgC,+CAInC,CAAC;AACX,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,8BAA8B,2FASjC,CAAC;AACX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,sCAAsC;AACtC,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAER;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACrE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACvD,iBAAiB;IACjB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,4BAA4B;AAC5B,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,2BAA2B,EAAE,GAC7C,WAAW,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAYlD"}

package/dist/notification-sources/field-paths.js

@@ -0,0 +1,86 @@
+/**
+ * 事件订阅通知能力 —— Block 0：字段路径原语（代码侧 source registry 的地基）。
+ *
+ * 为什么放 `packages/core` 而不是 contracts：
+ *   - 本文件是**纯 TS、零依赖**（core 没有 zod、没有 node:crypto），registry 框架要能被
+ *     db / worker / api 直接引用做「暴露面推导」，不该被 zod 绑架。
+ *   - contracts 侧（`packages/contracts/src/notifications.ts`）只负责 **wire 形状**（zod）。
+ *     两边各自 pin 同一份叶子路径清单，跨包一致性检查留给集成块（见设计文档 §12 验收点 A-38）。
+ *
+ * 铁律：字段路径是**开发者声明的 schema identifier**，不是用户输入。因此不做 trim /
+ * lowercase / NFKC 归一化——任何大小写或空白差异一律视为「未知字段」直接拒绝，
+ * 避免「后台保存的是 A、实际 hash 的是 B」。
+ */
+/**
+ * 受限字段路径语法：ASCII 点号叶子路径，segment 必须小写字母开头 + 字母数字。
+ * 明确**不**支持：转义、索引（`a.0.b`）、非 ASCII、空 segment。
+ * 数组整体即叶子（如 `trigger.supersededNodes`），永不产生索引路径。
+ */
+export const NOTIFICATION_FIELD_PATH_PATTERN = /^[a-z][A-Za-z0-9]*(?:\.[a-z][A-Za-z0-9]*)*$/;
+export function isNotificationFieldPath(value) {
+    return (typeof value === "string" && NOTIFICATION_FIELD_PATH_PATTERN.test(value));
+}
+/**
+ * 字段路径排序 comparator。
+ *
+ * ⚠️ 规范冻结为「按 **ASCII 字节字典序** 升序」，而不是含糊的「JS 默认排序」——
+ * JS 的 `<` 比较严格说是 UTF-16 code unit 序，与 code point 序在 BMP 外不一致。
+ * 由于路径语法已限制为 ASCII，三者在本域内结果相同；显式写出来是为了让
+ * 其它语言/其它层（SQL、Go agent）能一字不差地复现 fieldSetVersion。
+ */
+export function compareNotificationFieldPaths(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** 排序（不去重、不校验；调用方负责先 assert）。返回新数组。 */
+export function sortNotificationFieldPaths(paths) {
+    return [...paths].sort(compareNotificationFieldPaths);
+}
+/**
+ * 单条事件的触发形态（定义在本文件是为了让 {@link NotificationFieldDefinition.variants}
+ * 能强类型引用而不与 source-definition.ts 形成循环 import）。
+ *   - `scheduled_node`：正常到点。
+ *   - `catchup`：一次 overdue 折叠（多个错过的节点塌缩成一条，见设计文档 §7）。
+ */
+export const NOTIFICATION_TRIGGER_MODES = [
+    "scheduled_node",
+    "catchup",
+];
+/** 字段敏感度。后台**永远不能**改这个值——它是代码侧声明的暴露面等级。 */
+export const NOTIFICATION_FIELD_SENSITIVITIES = [
+    "public",
+    "internal",
+    "restricted",
+];
+/**
+ * 字段值形态（供后台展示与 agent 解析用；不是 zod 类型，wire 校验在 contracts）。
+ * `stringArray` 是「数组整体作为叶子」的唯一合法形态。
+ */
+export const NOTIFICATION_FIELD_VALUE_KINDS = [
+    "string",
+    "uuid",
+    "url",
+    "datetime",
+    "integer",
+    "ratio",
+    "enum",
+    "stringArray",
+];
+/** 便于书写与日志展示的 `resource:action` 串。 */
+export function formatNotificationFieldPermission(permission) {
+    return `${permission.resource}:${permission.action}`;
+}
+/** 建索引，供 O(1) 查找与未知路径拒绝。 */
+export function indexNotificationFields(fields) {
+    const map = new Map();
+    for (const field of fields) {
+        if (!isNotificationFieldPath(field.path)) {
+            throw new Error(`invalid notification field path: ${field.path}`);
+        }
+        if (map.has(field.path)) {
+            throw new Error(`duplicate notification field path: ${field.path}`);
+        }
+        map.set(field.path, field);
+    }
+    return map;
+}
+//# sourceMappingURL=field-paths.js.map

package/dist/notification-sources/field-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-paths.js","sourceRoot":"","sources":["../../src/notification-sources/field-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,6CAA6C,CAAC;AAEhD,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CACzE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAY,EAAE,KAAa;IACvE,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,0BAA0B,CACxC,KAAwB;IAExB,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,gBAAgB;IAChB,SAAS;CACD,CAAC;AAIX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,QAAQ;IACR,UAAU;IACV,YAAY;CACJ,CAAC;AAIX;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,QAAQ;IACR,MAAM;IACN,KAAK;IACL,UAAU;IACV,SAAS;IACT,OAAO;IACP,MAAM;IACN,aAAa;CACL,CAAC;AAaX,sCAAsC;AACtC,MAAM,UAAU,iCAAiC,CAC/C,UAAuC;IAEvC,OAAO,GAAG,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;AACvD,CAAC;AAmCD,4BAA4B;AAC5B,MAAM,UAAU,uBAAuB,CACrC,MAA8C;IAE9C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC3D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/notification-sources/field-set.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 事件订阅通知能力 —— Block 0：字段集推导（暴露面的唯一计算入口）。
+ *
+ * 三个身份必须分清（Codex 复审 P0-1，设计文档 §5）：
+ *
+ *   configuredFields  = 该 config **允许输出**的字段全集
+ *                     = commonRequired ∪ 全部 variantRequired ∪ selectedOptional ∪ 依赖闭包
+ *   fieldSetVersion   = sha256(canonical(configuredFields))  ← **配置级暴露政策身份**
+ *   includedFields    = 某条**具体事件**实际含有的叶子字段集合（⊆ configuredFields）
+ *
+ * 为什么 fieldSetVersion 不等于每条事件的 includedFields hash：catchup 事件比正常节点
+ * 多带折叠身份字段，若强求相等，同一份 config 就要有两个 fieldSetVersion，
+ * DTO 与 DB 都得双份。分开后 catchup / 字段依赖 / 配置切换的语义才自洽。
+ */
+import { type NotificationFieldDefinition, type NotificationTriggerMode } from "./field-paths.js";
+import type { NodeEventSourceDefinition } from "./source-definition.js";
+export declare class NotificationFieldSetError extends Error {
+    readonly reason: "unknown_field" | "duplicate_field" | "required_field_selected" | "required_field_not_declared" | "empty_field_set" | "configured_set_not_closed";
+    constructor(reason: "unknown_field" | "duplicate_field" | "required_field_selected" | "required_field_not_declared" | "empty_field_set" | "configured_set_not_closed", message: string);
+}
+/** required + optional 合并索引（source 声明期一次性建好；重复路径直接抛）。 */
+export declare function indexSourceFields(definition: NodeEventSourceDefinition): ReadonlyMap<string, NotificationFieldDefinition>;
+/**
+ * 后台勾选校验 —— **早拒**，绝不静默去重/静默丢弃。
+ * 拒绝理由（Codex 复审明确冻结）：未知路径、重复路径、把 required 当 optional 勾选。
+ */
+export declare function assertSelectableFields(definition: NodeEventSourceDefinition, selectedFields: readonly string[]): void;
+/**
+ * 推导**配置级**字段全集（fieldSetVersion 的输入）。
+ * 空 selectedFields 合法（结果仍含 required）；空结果集非法（registry 声明有误）。
+ */
+export declare function deriveConfiguredFields(definition: NodeEventSourceDefinition, selectedFields: readonly string[]): readonly string[];
+/**
+ * 推导**某条事件**的 includedFields。
+ * = configuredFields 中「适用于本 variant」的部分 ∪ 本 variant 的必填（再闭包一次）。
+ *
+ * 调用方（payload builder / DB 写入）**必须**用本函数的返回值，不得自造 includedFields —
+ * 否则「payload 多一个 restricted 字段 + includedFields 也多写一行」即可一起通过精确集校验。
+ */
+export declare function deriveIncludedFields(definition: NodeEventSourceDefinition, configuredFields: readonly string[], triggerMode: NotificationTriggerMode): readonly string[];
+/**
+ * 汇总一组字段所需的全部 authz 权限（AND 语义，去重后稳定排序）。
+ * 权限不足 → **整个 subscription 403**，不做字段级动态脱敏（设计文档 §9）。
+ */
+export declare function collectRequiredPermissions(definition: NodeEventSourceDefinition, fields: readonly string[]): readonly string[];
+//# sourceMappingURL=field-set.d.ts.map

package/dist/notification-sources/field-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-set.d.ts","sourceRoot":"","sources":["../../src/notification-sources/field-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE,qBAAa,yBAA0B,SAAQ,KAAK;IAEhD,QAAQ,CAAC,MAAM,EACX,eAAe,GACf,iBAAiB,GACjB,yBAAyB,GACzB,6BAA6B,GAC7B,iBAAiB,GACjB,2BAA2B;gBANtB,MAAM,EACX,eAAe,GACf,iBAAiB,GACjB,yBAAyB,GACzB,6BAA6B,GAC7B,iBAAiB,GACjB,2BAA2B,EAC/B,OAAO,EAAE,MAAM;CAKlB;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,yBAAyB,GACpC,WAAW,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAKlD;AAwBD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,yBAAyB,EACrC,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,IAAI,CAmCN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,yBAAyB,EACrC,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,SAAS,MAAM,EAAE,CA0BnB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,yBAAyB,EACrC,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,WAAW,EAAE,uBAAuB,GACnC,SAAS,MAAM,EAAE,CAuEnB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,yBAAyB,EACrC,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,SAAS,MAAM,EAAE,CAgBnB"}