@growth-labs/cms 0.5.8 → 0.5.9
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.
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"insights-ingest.d.ts","sourceRoot":"","sources":["../../src/schema/insights-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAevB,eAAO,MAAM,2BAA2B
|
|
1
|
+
{"version":3,"file":"insights-ingest.d.ts","sourceRoot":"","sources":["../../src/schema/insights-ingest.ts"],"names":[],"mappings":"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"}
|
|
@@ -11,6 +11,60 @@ import { z } from 'zod';
|
|
|
11
11
|
// content_insight_runs. HMAC authenticates the SENDER; it does NOT prevent
|
|
12
12
|
// replay — run_attempt is the monotonic guard.
|
|
13
13
|
// Reusable evidence/brief JSON shapes (stored as TEXT NOT NULL, zod-validated).
|
|
14
|
+
export const InsightLaneSchema = z.enum([
|
|
15
|
+
'commission',
|
|
16
|
+
'refresh',
|
|
17
|
+
'optimize-ctr',
|
|
18
|
+
'consolidate',
|
|
19
|
+
'monitor',
|
|
20
|
+
]);
|
|
21
|
+
export const InsightScoreBreakdownSchema = z.object({
|
|
22
|
+
actualCtr: z.number().min(0).max(1),
|
|
23
|
+
expectedCtr: z.number().min(0).max(1),
|
|
24
|
+
expectedClicksGain: z.number().nonnegative(),
|
|
25
|
+
laneWeight: z.number().min(0).max(1),
|
|
26
|
+
score: z.number().nonnegative(),
|
|
27
|
+
targetPosition: z.number().nonnegative(),
|
|
28
|
+
topicalFit: z.number().min(0).max(1),
|
|
29
|
+
winnabilityPrior: z.number().min(0).max(1),
|
|
30
|
+
});
|
|
31
|
+
export const InsightJudgeReasonCodeSchema = z.enum([
|
|
32
|
+
'no_coherent_intent',
|
|
33
|
+
'navigational_or_entity_locked',
|
|
34
|
+
'off_topic',
|
|
35
|
+
'already_covered',
|
|
36
|
+
'unwinnable',
|
|
37
|
+
'unsustainable_format',
|
|
38
|
+
'too_thin',
|
|
39
|
+
'accept',
|
|
40
|
+
]);
|
|
41
|
+
export const InsightJudgeVerdictSchema = z.enum(['accept', 'reject', 'abstain']);
|
|
42
|
+
export const InsightWinnabilityEvidenceSchema = z.object({
|
|
43
|
+
verdict: InsightJudgeVerdictSchema,
|
|
44
|
+
confidence: z.number().min(0).max(1),
|
|
45
|
+
serp_summary: z.string().min(1),
|
|
46
|
+
});
|
|
47
|
+
export const InsightJudgeEvidenceSchema = z.object({
|
|
48
|
+
verdict: InsightJudgeVerdictSchema,
|
|
49
|
+
reason_code: InsightJudgeReasonCodeSchema,
|
|
50
|
+
confidence: z.number().min(0).max(1),
|
|
51
|
+
intent_statement: z.string().min(1),
|
|
52
|
+
winnability: InsightWinnabilityEvidenceSchema.optional(),
|
|
53
|
+
});
|
|
54
|
+
export const InsightSemanticEvidenceSchema = z.object({
|
|
55
|
+
topicalFit: z.number().min(0).max(1),
|
|
56
|
+
disposition: z.enum(['reject', 'judge_only', 'advance']),
|
|
57
|
+
coverageSimilarity: z.number().min(-1).max(1),
|
|
58
|
+
coverageAligned: z.boolean(),
|
|
59
|
+
sharedConcepts: z.number().int().nonnegative(),
|
|
60
|
+
nearest: z
|
|
61
|
+
.array(z.object({
|
|
62
|
+
title: z.string().min(1),
|
|
63
|
+
slug: z.string().min(1),
|
|
64
|
+
similarity: z.number().min(-1).max(1),
|
|
65
|
+
}))
|
|
66
|
+
.max(3),
|
|
67
|
+
});
|
|
14
68
|
export const InsightEvidenceDemandSchema = z.object({
|
|
15
69
|
query: z.string().min(1),
|
|
16
70
|
impressions: z.number().int().nonnegative(),
|
|
@@ -18,10 +72,20 @@ export const InsightEvidenceDemandSchema = z.object({
|
|
|
18
72
|
ctr: z.number().min(0).max(1),
|
|
19
73
|
position: z.number().nonnegative(),
|
|
20
74
|
trend: z.number(),
|
|
75
|
+
lane: InsightLaneSchema.optional(),
|
|
76
|
+
coveredBy: z.string().url().nullable().optional(),
|
|
77
|
+
coverageSource: z.enum(['page_join', 'semantic', 'lexical']).nullable().optional(),
|
|
78
|
+
scoreBreakdown: InsightScoreBreakdownSchema.optional(),
|
|
79
|
+
judge: InsightJudgeEvidenceSchema.optional(),
|
|
80
|
+
semantic: InsightSemanticEvidenceSchema.optional(),
|
|
21
81
|
});
|
|
22
82
|
export const InsightEvidenceOpportunitySchema = z.object({
|
|
23
83
|
basis: z.string().min(1),
|
|
24
84
|
source_count: z.number().int().nonnegative(),
|
|
85
|
+
lane: InsightLaneSchema.optional(),
|
|
86
|
+
scoreBreakdown: InsightScoreBreakdownSchema.optional(),
|
|
87
|
+
judge: InsightJudgeEvidenceSchema.optional(),
|
|
88
|
+
semantic: InsightSemanticEvidenceSchema.optional(),
|
|
25
89
|
});
|
|
26
90
|
export const InsightEvidenceSchema = z.union([
|
|
27
91
|
InsightEvidenceDemandSchema,
|
|
@@ -47,6 +111,20 @@ export const InsightBriefSchema = z.object({
|
|
|
47
111
|
title: z.string().min(1),
|
|
48
112
|
url: z.string().url(),
|
|
49
113
|
})),
|
|
114
|
+
format: z.enum(['cornerstone', 'pillar', 'standalone']).optional(),
|
|
115
|
+
content_outline: z
|
|
116
|
+
.array(z.object({
|
|
117
|
+
question: z.string().min(1),
|
|
118
|
+
demand: z
|
|
119
|
+
.object({
|
|
120
|
+
query: z.string().min(1),
|
|
121
|
+
impressions: z.number().int().nonnegative(),
|
|
122
|
+
position: z.number().nonnegative(),
|
|
123
|
+
trend: z.number(),
|
|
124
|
+
})
|
|
125
|
+
.optional(),
|
|
126
|
+
}))
|
|
127
|
+
.optional(),
|
|
50
128
|
/**
|
|
51
129
|
* Which open-web discovery STREAM produced this opportunity row (the theater
|
|
52
130
|
* split). REQUIRED here: Zod strips unknown brief keys, so without this field the
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"insights-ingest.js","sourceRoot":"","sources":["../../src/schema/insights-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,wEAAwE;AACxE,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,8DAA8D;AAC9D,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,gFAAgF;AAChF,2EAA2E;AAC3E,+CAA+C;AAE/C,gFAAgF;AAChF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;
|
|
1
|
+
{"version":3,"file":"insights-ingest.js","sourceRoot":"","sources":["../../src/schema/insights-ingest.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -13,6 +13,69 @@ import { z } from 'zod'
|
|
|
13
13
|
// replay — run_attempt is the monotonic guard.
|
|
14
14
|
|
|
15
15
|
// Reusable evidence/brief JSON shapes (stored as TEXT NOT NULL, zod-validated).
|
|
16
|
+
export const InsightLaneSchema = z.enum([
|
|
17
|
+
'commission',
|
|
18
|
+
'refresh',
|
|
19
|
+
'optimize-ctr',
|
|
20
|
+
'consolidate',
|
|
21
|
+
'monitor',
|
|
22
|
+
])
|
|
23
|
+
|
|
24
|
+
export const InsightScoreBreakdownSchema = z.object({
|
|
25
|
+
actualCtr: z.number().min(0).max(1),
|
|
26
|
+
expectedCtr: z.number().min(0).max(1),
|
|
27
|
+
expectedClicksGain: z.number().nonnegative(),
|
|
28
|
+
laneWeight: z.number().min(0).max(1),
|
|
29
|
+
score: z.number().nonnegative(),
|
|
30
|
+
targetPosition: z.number().nonnegative(),
|
|
31
|
+
topicalFit: z.number().min(0).max(1),
|
|
32
|
+
winnabilityPrior: z.number().min(0).max(1),
|
|
33
|
+
})
|
|
34
|
+
|
|
35
|
+
export const InsightJudgeReasonCodeSchema = z.enum([
|
|
36
|
+
'no_coherent_intent',
|
|
37
|
+
'navigational_or_entity_locked',
|
|
38
|
+
'off_topic',
|
|
39
|
+
'already_covered',
|
|
40
|
+
'unwinnable',
|
|
41
|
+
'unsustainable_format',
|
|
42
|
+
'too_thin',
|
|
43
|
+
'accept',
|
|
44
|
+
])
|
|
45
|
+
|
|
46
|
+
export const InsightJudgeVerdictSchema = z.enum(['accept', 'reject', 'abstain'])
|
|
47
|
+
|
|
48
|
+
export const InsightWinnabilityEvidenceSchema = z.object({
|
|
49
|
+
verdict: InsightJudgeVerdictSchema,
|
|
50
|
+
confidence: z.number().min(0).max(1),
|
|
51
|
+
serp_summary: z.string().min(1),
|
|
52
|
+
})
|
|
53
|
+
|
|
54
|
+
export const InsightJudgeEvidenceSchema = z.object({
|
|
55
|
+
verdict: InsightJudgeVerdictSchema,
|
|
56
|
+
reason_code: InsightJudgeReasonCodeSchema,
|
|
57
|
+
confidence: z.number().min(0).max(1),
|
|
58
|
+
intent_statement: z.string().min(1),
|
|
59
|
+
winnability: InsightWinnabilityEvidenceSchema.optional(),
|
|
60
|
+
})
|
|
61
|
+
|
|
62
|
+
export const InsightSemanticEvidenceSchema = z.object({
|
|
63
|
+
topicalFit: z.number().min(0).max(1),
|
|
64
|
+
disposition: z.enum(['reject', 'judge_only', 'advance']),
|
|
65
|
+
coverageSimilarity: z.number().min(-1).max(1),
|
|
66
|
+
coverageAligned: z.boolean(),
|
|
67
|
+
sharedConcepts: z.number().int().nonnegative(),
|
|
68
|
+
nearest: z
|
|
69
|
+
.array(
|
|
70
|
+
z.object({
|
|
71
|
+
title: z.string().min(1),
|
|
72
|
+
slug: z.string().min(1),
|
|
73
|
+
similarity: z.number().min(-1).max(1),
|
|
74
|
+
}),
|
|
75
|
+
)
|
|
76
|
+
.max(3),
|
|
77
|
+
})
|
|
78
|
+
|
|
16
79
|
export const InsightEvidenceDemandSchema = z.object({
|
|
17
80
|
query: z.string().min(1),
|
|
18
81
|
impressions: z.number().int().nonnegative(),
|
|
@@ -20,11 +83,21 @@ export const InsightEvidenceDemandSchema = z.object({
|
|
|
20
83
|
ctr: z.number().min(0).max(1),
|
|
21
84
|
position: z.number().nonnegative(),
|
|
22
85
|
trend: z.number(),
|
|
86
|
+
lane: InsightLaneSchema.optional(),
|
|
87
|
+
coveredBy: z.string().url().nullable().optional(),
|
|
88
|
+
coverageSource: z.enum(['page_join', 'semantic', 'lexical']).nullable().optional(),
|
|
89
|
+
scoreBreakdown: InsightScoreBreakdownSchema.optional(),
|
|
90
|
+
judge: InsightJudgeEvidenceSchema.optional(),
|
|
91
|
+
semantic: InsightSemanticEvidenceSchema.optional(),
|
|
23
92
|
})
|
|
24
93
|
|
|
25
94
|
export const InsightEvidenceOpportunitySchema = z.object({
|
|
26
95
|
basis: z.string().min(1),
|
|
27
96
|
source_count: z.number().int().nonnegative(),
|
|
97
|
+
lane: InsightLaneSchema.optional(),
|
|
98
|
+
scoreBreakdown: InsightScoreBreakdownSchema.optional(),
|
|
99
|
+
judge: InsightJudgeEvidenceSchema.optional(),
|
|
100
|
+
semantic: InsightSemanticEvidenceSchema.optional(),
|
|
28
101
|
})
|
|
29
102
|
|
|
30
103
|
export const InsightEvidenceSchema = z.union([
|
|
@@ -55,6 +128,22 @@ export const InsightBriefSchema = z.object({
|
|
|
55
128
|
url: z.string().url(),
|
|
56
129
|
}),
|
|
57
130
|
),
|
|
131
|
+
format: z.enum(['cornerstone', 'pillar', 'standalone']).optional(),
|
|
132
|
+
content_outline: z
|
|
133
|
+
.array(
|
|
134
|
+
z.object({
|
|
135
|
+
question: z.string().min(1),
|
|
136
|
+
demand: z
|
|
137
|
+
.object({
|
|
138
|
+
query: z.string().min(1),
|
|
139
|
+
impressions: z.number().int().nonnegative(),
|
|
140
|
+
position: z.number().nonnegative(),
|
|
141
|
+
trend: z.number(),
|
|
142
|
+
})
|
|
143
|
+
.optional(),
|
|
144
|
+
}),
|
|
145
|
+
)
|
|
146
|
+
.optional(),
|
|
58
147
|
/**
|
|
59
148
|
* Which open-web discovery STREAM produced this opportunity row (the theater
|
|
60
149
|
* split). REQUIRED here: Zod strips unknown brief keys, so without this field the
|
|
@@ -124,3 +213,8 @@ export const InsightsIngestPayloadSchema = z
|
|
|
124
213
|
export type InsightsIngestPayload = z.infer<typeof InsightsIngestPayloadSchema>
|
|
125
214
|
export type InsightsIngestMeta = z.infer<typeof InsightsIngestMetaSchema>
|
|
126
215
|
export type InsightSuggestionRowPayload = z.infer<typeof InsightSuggestionRowSchema>
|
|
216
|
+
export type InsightLane = z.infer<typeof InsightLaneSchema>
|
|
217
|
+
export type InsightScoreBreakdown = z.infer<typeof InsightScoreBreakdownSchema>
|
|
218
|
+
export type InsightJudgeReasonCode = z.infer<typeof InsightJudgeReasonCodeSchema>
|
|
219
|
+
export type InsightJudgeVerdict = z.infer<typeof InsightJudgeVerdictSchema>
|
|
220
|
+
export type InsightJudgeEvidence = z.infer<typeof InsightJudgeEvidenceSchema>
|