@tomako/tools-runtime 0.1.0

package/src/lib/tools/community-pain-point-extractor-schema.ts

@@ -0,0 +1,166 @@
+import { z } from "zod";
+
+export const COMMUNITY_PAIN_POINT_EXTRACTOR_RESULT_TYPE = "community_pain_point_extractor";
+export const COMMUNITY_PAIN_POINT_EXTRACTOR_SCENE = "community_pain_point_extractor";
+export const COMMUNITY_PAIN_POINT_EXTRACTOR_PROMPT_VERSION =
+  "community-pain-point-extractor.v1";
+
+const invalidDirectionPattern =
+  /^(test|demo|placeholder|asdf|123|111|hello|hi|pain point|用户痛点|用户调研)$/i;
+
+export const communityPainPointExtractorInputSchema = z.object({
+  direction: z
+    .string()
+    .trim()
+    .min(10)
+    .max(1800)
+    .refine((value) => !invalidDirectionPattern.test(value), "placeholder"),
+  targetUsers: z.string().trim().max(500).optional(),
+  market: z.string().trim().max(160).optional(),
+  primaryPlatform: z
+    .enum(["all", "reddit", "x", "hackernews"])
+    .default("all"),
+  focus: z.string().trim().max(500).optional(),
+});
+
+export type CommunityPainPointExtractorInput = z.infer<
+  typeof communityPainPointExtractorInputSchema
+>;
+
+const confidence = z.enum(["low", "medium", "high"]).catch("low");
+const frequency = z.enum(["low", "medium", "high"]).catch("medium");
+const severity = z.enum(["low", "medium", "high"]).catch("medium");
+const platform = z.enum(["reddit", "x", "hackernews", "other"]).catch("other");
+const reportStatus = z.enum(["partial", "final"]).catch("final");
+const reportSection = z
+  .enum([
+    "summary",
+    "communities",
+    "paidIntent",
+    "entryFeatures",
+    "painClusters",
+    "landing",
+    "experiments",
+    "sources",
+  ])
+  .catch("summary");
+
+const sourceSchema = z.object({
+  label: z.string(),
+  url: z.string().optional(),
+  platform,
+  note: z.string().optional(),
+});
+
+const quoteSchema = z.object({
+  quote: z.string(),
+  sourceLabel: z.string(),
+  sourceUrl: z.string().optional(),
+  platform,
+  note: z.string().optional(),
+});
+
+export const communityPainPointExtractorResultSchema = z.object({
+  reportStatus: reportStatus.default("final"),
+  completedSections: z.array(reportSection).default([]),
+  inProgressSection: reportSection.optional(),
+  directionTitle: z.string().default(""),
+  summary: z.string().default(""),
+  communityMap: z
+    .array(
+      z.object({
+        platform,
+        communityName: z.string(),
+        url: z.string().optional(),
+        whyRelevant: z.string(),
+        audienceFit: z.string().optional(),
+        confidence,
+      }),
+    )
+    .default([]),
+  painClusters: z
+    .array(
+      z.object({
+        title: z.string(),
+        summary: z.string(),
+        frequency,
+        severity,
+        platforms: z.array(platform).default([]),
+        userQuotes: z.array(quoteSchema).default([]),
+        audienceSegments: z.array(z.string()).default([]),
+        currentWorkarounds: z.array(z.string()).default([]),
+        suggestedMicroFeature: z.string(),
+        landingPageAngle: z.string(),
+        willingnessToPay: z.object({
+          signal: z.string(),
+          confidence,
+        }),
+      }),
+    )
+    .default([]),
+  complaintPatterns: z
+    .array(
+      z.object({
+        complaint: z.string(),
+        frequency,
+        evidence: z.string(),
+        platforms: z.array(platform).default([]),
+      }),
+    )
+    .default([]),
+  paidIntent: z
+    .object({
+      signals: z.array(z.string()).default([]),
+      objections: z.array(z.string()).default([]),
+      pricingClues: z.array(z.string()).default([]),
+      confidence,
+    })
+    .default({
+      signals: [],
+      objections: [],
+      pricingClues: [],
+      confidence: "low",
+    }),
+  landingPageAngles: z
+    .array(
+      z.object({
+        headline: z.string(),
+        promise: z.string(),
+        targetSegment: z.string(),
+        proofToCollect: z.string(),
+        cta: z.string(),
+      }),
+    )
+    .default([]),
+  entryFeatures: z
+    .array(
+      z.object({
+        feature: z.string(),
+        whyItCutsIn: z.string(),
+        risk: z.string().optional(),
+      }),
+    )
+    .default([]),
+  validationExperiments: z
+    .array(
+      z.object({
+        title: z.string(),
+        channel: z.string(),
+        method: z.string(),
+        successMetric: z.string(),
+      }),
+    )
+    .default([]),
+  missingEvidence: z.array(z.string()).default([]),
+  sources: z.array(sourceSchema).default([]),
+  disclaimer: z.string().default(""),
+  promptVersion: z.string().default(COMMUNITY_PAIN_POINT_EXTRACTOR_PROMPT_VERSION),
+  generatedAt: z.string().optional(),
+});
+
+export type CommunityPainPointExtractorResult = z.infer<
+  typeof communityPainPointExtractorResultSchema
+>;
+export type CommunityPainPointFrequency = z.infer<typeof frequency>;
+export type CommunityPainPointSeverity = z.infer<typeof severity>;
+export type CommunityPainPointConfidence = z.infer<typeof confidence>;

package/src/lib/tools/community-post-risk-checker-schema.ts

@@ -0,0 +1,99 @@
+import { z } from "zod";
+
+export const communityPostCommunities = [
+  "redditSaas",
+  "redditIndieHackers",
+  "indieHackers",
+  "other",
+] as const;
+
+export const communityPostGoals = [
+  "askFeedback",
+  "shareLearning",
+  "launchUpdate",
+  "findBeta",
+  "askAdvice",
+] as const;
+
+export const communityPostCtaPlans = [
+  "none",
+  "body",
+  "comment",
+  "onlyIfAsked",
+  "unsure",
+] as const;
+
+export const communityPostLanguages = ["zh", "en"] as const;
+
+export const communityPostRiskBriefSchema = z.object({
+  title: z.string().trim().min(8).max(180),
+  postBody: z.string().trim().min(120).max(8000),
+  community: z.enum(communityPostCommunities),
+  goal: z.enum(communityPostGoals),
+  ctaPlan: z.enum(communityPostCtaPlans),
+  linkIncluded: z.boolean().default(false),
+  language: z.enum(communityPostLanguages).default("en"),
+});
+
+export type CommunityPostCommunity = (typeof communityPostCommunities)[number];
+export type CommunityPostGoal = (typeof communityPostGoals)[number];
+export type CommunityPostCtaPlan = (typeof communityPostCtaPlans)[number];
+export type CommunityPostLanguage = (typeof communityPostLanguages)[number];
+export type CommunityPostRiskBrief = z.infer<typeof communityPostRiskBriefSchema>;
+
+export type CommunityPostRiskLevel = "low" | "medium" | "high";
+export type CommunityPostRiskStatus = "pass" | "watch" | "risk";
+
+export type CommunityPostCheckId =
+  | "titlePromotion"
+  | "ctaTiming"
+  | "processEvidence"
+  | "communityTone"
+  | "selfPromotion"
+  | "transparency";
+
+export interface CommunityPostRiskCheck {
+  id: CommunityPostCheckId;
+  label: string;
+  status: CommunityPostRiskStatus;
+  score: number;
+  reason: string;
+  fix: string;
+}
+
+export interface CommunityPostFlaggedParagraph {
+  index: number;
+  riskLevel: CommunityPostRiskLevel;
+  text: string;
+  reason: string;
+  suggestion: string;
+}
+
+export interface CommunityPostCtaAdvice {
+  placement: string;
+  rationale: string;
+  saferAlternative: string;
+}
+
+export interface CommunityPostRiskReport {
+  summary: {
+    riskScore: number;
+    riskLevel: CommunityPostRiskLevel;
+    verdict: string;
+    primaryFix: string;
+    recommendedCtaPlacement: string;
+  };
+  checks: CommunityPostRiskCheck[];
+  flaggedParagraphs: CommunityPostFlaggedParagraph[];
+  ctaAdvice: CommunityPostCtaAdvice;
+  revisionPlan: string[];
+  missingInfo: string[];
+  reviewChecklist: string[];
+  metadata: {
+    community: CommunityPostCommunity;
+    goal: CommunityPostGoal;
+    paragraphCount: number;
+    linkIncluded: boolean;
+    language: CommunityPostLanguage;
+  };
+}