Campaigns and results
The services behind Campaigns (the board, campaign pages, plans,
approvals and Autopilot) and the measured results. Package pulse.v1; the
least role of each method is in its table. See
Autopilot and agencies.
Notes
- Measured only. Metrics come from connected sources: Google Analytics 4
as channel
web, Google Ads asgoogle_ads, Google Search Console clicks and impressions, and the leads PULSE holds. Published posts have their own results, read back intopost_results. A channel with no connector has no rows. A figure is counted only whenmeasured_fieldsnames it;measured_daysof 0 means nothing was measured. Nothing writes follower counts. - Forecasts.
GetForecastsplits the cached Google Analytics series into trend, seasonality and changepoints and extends it, without a live Google call and without model inference.season_period_daysis 0 when no seasonality was found. - Autopilot queues approved posts at the account’s best time through the same publishing gate as any scheduled post, so the switches on Switches and arming order still decide at send time. Replies drafted from read-back comments wait in the approval queue.
- Automations do outbound work only with
PULSE_PUBLISH_AUTOMATIONSand each step’s own channel switch; a dry run never sends. - Campaign plans. Go lays out the calendar from the person’s capacity and
dates; the
campaign-planskill fills the posts; checks reject plans over capacity or with missing fields. KPI results come only frompost_results.
CampaignService
Campaign CRUD, budget tracking, and archiving.
pulse.v1.CampaignService, declared in pulse.proto.
| Method | Request → Response | Least role | Notes |
|---|---|---|---|
CreateCampaign | CreateCampaignRequest → Campaign | editor | CreateCampaign creates a new marketing campaign. |
GetCampaign | GetCampaignRequest → Campaign | viewer | GetCampaign returns a campaign by ID. |
ListCampaigns | ListCampaignsRequest → ListCampaignsResponse | viewer | ListCampaigns returns paginated campaigns. |
UpdateCampaign | UpdateCampaignRequest → Campaign | editor | UpdateCampaign updates campaign details. |
DeleteCampaign | DeleteCampaignRequest → google.protobuf.Empty | editor | DeleteCampaign soft-deletes a campaign. |
ArchiveCampaign | ArchiveCampaignRequest → Campaign | editor | ArchiveCampaign moves a campaign to archived status. |
ListCampaignPlans | ListCampaignPlansRequest → ListCampaignPlansResponse | viewer | ListCampaignPlans lists the caller’s campaign plans: the campaigns an audit’s content gaps proposed, with their state, newest first. |
GetCampaignPlan | GetCampaignPlanRequest → CampaignPlan | viewer | GetCampaignPlan returns one campaign’s plan: the gaps it was proposed from, its content strategy and its roadmap, one board per channel. |
AcceptCampaignProposal | AcceptCampaignProposalRequest → CampaignPlan | editor | AcceptCampaignProposal accepts a proposed campaign (with the user’s edits) and prepares its content strategy and roadmap in the background; GetCampaignPlan reports the progress. Nothing is published. |
DismissCampaignProposal | DismissCampaignProposalRequest → CampaignPlan | editor | DismissCampaignProposal dismisses a proposal; the campaign row is kept. |
DraftCampaignProposal | DraftCampaignProposalRequest → CampaignPlan | editor | DraftCampaignProposal prepares a proposal’s strategy and roadmap in the background WITHOUT accepting it, so its board can be read before the choice; accepting it then keeps that board. Nothing is published. |
SetCampaignStatus | SetCampaignStatusRequest → Campaign | editor | SetCampaignStatus starts, pauses or resumes a campaign (ACTIVE or PAUSED only). The daily engines work only on active campaigns; an archived campaign is refused. |
Also uses Channel, CampaignStatus, PaginationRequest, PaginationResponse, ContentGapsResponse, ContentStrategyResponse, ContentGap, ContentPillar, GapEvidence.
message SetCampaignStatusRequest {
string id = 1;
CampaignStatus status = 2; // CAMPAIGN_STATUS_ACTIVE | CAMPAIGN_STATUS_PAUSED
}
// The state of a campaign plan.
enum CampaignPlanState {
CAMPAIGN_PLAN_STATE_UNSPECIFIED = 0;
// Proposed from an audit's content gaps; waiting for the user.
CAMPAIGN_PLAN_STATE_PROPOSED = 1;
// Accepted; the strategy and roadmap are being prepared.
CAMPAIGN_PLAN_STATE_PREPARING = 2;
// Strategy and roadmap are ready.
CAMPAIGN_PLAN_STATE_READY = 3;
// Preparing failed; detail says why. Accepting again retries.
CAMPAIGN_PLAN_STATE_FAILED = 4;
CAMPAIGN_PLAN_STATE_DISMISSED = 5;
// Still a proposal; its strategy and roadmap are being drafted.
CAMPAIGN_PLAN_STATE_DRAFTING = 6;
}
message ListCampaignPlansRequest {}
message ListCampaignPlansResponse {
repeated CampaignPlan plans = 1; // summaries: no strategy, gaps or boards
}
message GetCampaignPlanRequest {
string campaign_id = 1;
}
message AcceptCampaignProposalRequest {
string campaign_id = 1;
// The user's edits; empty keeps the proposed value.
string name = 2;
string objective = 3;
string description = 4;
}
message DismissCampaignProposalRequest {
string campaign_id = 1;
}
message DraftCampaignProposalRequest {
string campaign_id = 1;
}
message CampaignPlan {
Campaign campaign = 1;
CampaignPlanState state = 2;
// Why the state is what it is: the failure, or the step being prepared.
string detail = 3;
// The goal chip of the audit the objective was matched to ("" = none of
// the audit's goals maps to a campaign objective).
string goal = 4;
// Why PULSE proposed this campaign, citing the gaps.
string rationale = 5;
string audit_run_id = 6;
string domain = 7;
// The gaps the proposal was made from (unset in a list).
ContentGapsResponse gaps = 8;
// Unset until the strategy is prepared (and in a list).
ContentStrategyResponse strategy = 9;
// One board per channel, in the order of the channels.
repeated RoadmapBoard boards = 10;
// Where the boards' channels came from: "settings" (the active channels
// in Settings) or "campaign" (none set there; the campaign's channels).
string channels_source = 11;
// The roadmap run's verdicts, accepted AND withheld.
runink.ui.judgement.v1.JudgementSet roadmap_judgements = 12;
google.protobuf.Timestamp updated_at = 13;
// When the check-up (audit_run_id) this proposal came from ran; unset
// when it is not known (no run, or the run was removed).
google.protobuf.Timestamp audit_at = 14;
}
message RoadmapBoard {
Channel channel = 1;
repeated RoadmapItem items = 2;
}
// One planned piece of the roadmap and the Studio function that makes it.
message RoadmapItem {
string id = 1;
string campaign_id = 2;
Channel channel = 3;
int32 week = 4; // 1-based week of the campaign
string phase = 5;
// post | article | whitepaper | podcast | short | presentation |
// infographic | course | email
string format = 6;
string topic = 7;
string brief = 8;
// The content gap this item closes ("" = none cited).
string gap_topic = 9;
// The Studio tab that makes this format (/studio?tab=…).
string studio_tab = 10;
// The content row made for it ("" = not created yet).
string content_id = 11;
// That row's place on the board: draft | review | approved | scheduled |
// published | rejected; "" when there is no row.
string content_state = 12;
string content_title = 13;
runink.ui.judgement.v1.Judgement judgement = 14;
// Why the reviewer rejected that row (its reviewer notes); set only when
// content_state is "rejected", "" when no reason was given.
string content_notes = 15;
}
message Campaign {
string id = 1;
string user_id = 2;
string name = 3;
string description = 4;
string objective = 5; // "brand_awareness", "lead_gen", "engagement", "sales"
repeated Channel channels = 6;
CampaignStatus status = 7;
double budget = 8;
double spent = 9;
string currency = 10; // "BRL", "USD", etc.
google.protobuf.Timestamp start_date = 11;
google.protobuf.Timestamp end_date = 12;
string target_audience = 13;
map<string, string> metadata = 14;
google.protobuf.Timestamp created_at = 15;
google.protobuf.Timestamp updated_at = 16;
// Diagnostic this campaign was created from, when set via the diagnostic
// result page's "Create Campaign" action — empty for campaigns created
// standalone from the Campaigns screen.
string diagnostic_id = 17;
// False while nothing writes a measured spend for this campaign: `spent`
// is then not a figure and must be shown as not measured, never as 0.
bool spend_measured = 18;
}
message CreateCampaignRequest {
string name = 1;
string description = 2;
string objective = 3;
repeated Channel channels = 4;
double budget = 5;
string currency = 6;
google.protobuf.Timestamp start_date = 7;
google.protobuf.Timestamp end_date = 8;
string target_audience = 9;
string diagnostic_id = 10;
}
message GetCampaignRequest {
string id = 1;
}
message ListCampaignsRequest {
PaginationRequest pagination = 1;
CampaignStatus status_filter = 2;
}
message ListCampaignsResponse {
repeated Campaign campaigns = 1;
PaginationResponse pagination = 2;
}
message UpdateCampaignRequest {
string id = 1;
string name = 2;
string description = 3;
string objective = 4;
repeated Channel channels = 5;
double budget = 6;
string currency = 7;
google.protobuf.Timestamp start_date = 8;
google.protobuf.Timestamp end_date = 9;
string target_audience = 10;
}
message DeleteCampaignRequest {
string id = 1;
}
message ArchiveCampaignRequest {
string id = 1;
}ContentPlanService
ContentPlanService — a campaign as a real content plan (owner, 2026-10-29): campaign › phases (dated, around an optional event) › posts (a calendar row each: date, format, topic, persona, hook, call to action, posting time in the account’s time zone), a Stories plan per day on Instagram, a tone of voice per persona and three KPIs.
The rules a reader can rely on: * The person states the capacity (posts per week per channel, stories per day) and the dates; PULSE lays the calendar out inside them, keeps the promotional ratio, and posts at the account’s MEASURED best time where results exist, otherwise at a starting time it labels as not measured. * The model proposes topics, hooks and personas through the campaign-plan skill (TOON); Go checks capacity, ratio, dates and duplicates; OpenBias and the plan gate judge the plan. A withheld plan is not saved. * Personas come from the account’s audit and leads, never invented. * KPI targets are proposals; KPI results are measurements read from the account’s published posts, absent until something was measured. * Nothing here publishes. A post is written in Studio and approved on the Drafts tab; approval hands it to the existing autopilot schedule and dispatch gate (PULSE_APPLY_ENABLED + per-channel switches).
pulse.v1.ContentPlanService, declared in content_plan.proto.
| Method | Request → Response | Least role | Notes |
|---|---|---|---|
ProposeContentPlan | ProposeContentPlanRequest → ContentPlan | editor | ProposeContentPlan lays out (or lays out again) a campaign’s plan from the person’s capacity and dates. Posts already written are kept. |
GetContentPlan | GetContentPlanRequest → ContentPlan | viewer | GetContentPlan returns a campaign’s plan with its KPI results as measured now. NotFound when the campaign has none yet. |
Also uses Channel.
// How much the person can do on one channel.
message ChannelCapacity {
Channel channel = 1;
// Feed posts a week on this channel (1-14).
int32 posts_per_week = 2;
}
message ProposeContentPlanRequest {
string campaign_id = 1;
// YYYY-MM-DD, the first and last day of the campaign.
string start_date = 2;
string end_date = 3;
// YYYY-MM-DD of the event the campaign is built around; "" = none.
string event_date = 4;
// Days the event lasts (1 when unset).
int32 event_days = 5;
repeated ChannelCapacity capacity = 6;
// Instagram Stories per day during the live phase (0 = no Stories plan).
int32 stories_per_day = 7;
// One promotional post in every N (e.g. 4 = 1 in 4). 0 = PULSE's default of 4.
int32 promo_every = 8;
}
message GetContentPlanRequest {
string campaign_id = 1;
}
// One dated phase of the campaign.
message PlanPhase {
// build_up | live | follow_up
string kind = 1;
string name = 2;
string start_date = 3;
string end_date = 4;
// What this phase is for, in plain words (the model's proposal).
string goal = 5;
}
// One post on the calendar.
message PlannedPost {
// The roadmap item it is (Studio's Create/Edit write it).
string id = 1;
string campaign_id = 2;
Channel channel = 3;
// build_up | live | follow_up
string phase = 4;
string date = 5;
// HH:MM in the account's time zone.
string time = 6;
// true = the time is the account's measured best time; false = a starting
// suggestion, not measured yet.
bool time_measured = 7;
// carousel | reel | single_image | short | video | post
string format = 8;
string topic = 9;
string persona = 10;
string hook = 11;
string cta = 12;
bool promo = 13;
// The written piece, once Studio made it ("" = not written yet), and where
// it is: draft | review | approved | scheduled | published | rejected.
string content_id = 14;
string content_state = 15;
// Why the reviewer rejected it; only when content_state is "rejected".
string content_notes = 16;
}
// One Story on an Instagram day.
message PlannedStory {
string id = 1;
string date = 2;
string time = 3;
string visual = 4;
string text = 5;
// poll | quiz | question | link | none
string sticker = 6;
}
// How the business sounds to one persona.
message PersonaTone {
string persona = 1;
repeated string adjectives = 2;
string example = 3;
}
// One campaign KPI: the target is PULSE's proposal; the result is measured.
message PlanKpi {
string name = 1;
// impressions | reactions | comments | engagement | posts_published
string metric = 2;
// The proposed target for the whole campaign.
double target = 3;
// Measured from the campaign's published posts; absent until measured.
optional double result = 4;
// Posts the result was measured from.
int32 measured_posts = 5;
}
// One deterministic check on the plan.
message PlanCheck {
string id = 1;
bool pass = 2;
repeated string findings = 3;
}
message ContentPlan {
string campaign_id = 1;
string start_date = 2;
string end_date = 3;
string event_date = 4;
int32 event_days = 5;
repeated ChannelCapacity capacity = 6;
int32 stories_per_day = 7;
int32 promo_every = 8;
// The account's time zone as minutes east of UTC.
int32 utc_offset_minutes = 9;
repeated PlanPhase phases = 10;
repeated PlannedPost posts = 11;
repeated PlannedStory stories = 12;
repeated PersonaTone tone = 13;
repeated PlanKpi kpis = 14;
repeated PlanCheck checks = 15;
// concur | unable | off: the plan gate's verdict on the plan.
string verdict = 16;
string verdict_reason = 17;
// Plain notes: what PULSE could not do or measure.
repeated string notes = 18;
string updated_at = 19;
}EpicService
SERVICE: EpicService — Epics and Milestones (replaces the Strategy Roadmap) An epic is one campaign objective with a measured KPI, an accountable owner (who created it), a named approver and RACI. A milestone is a dated gate with an exit threshold on that KPI and a Definition of Done; the campaign’s roadmap items roll up into milestones. Every figure (KPI, forecast, control chart, schedule index) is computed in Go from stored measurements; a figure that cannot be computed is unset with the reason, never 0.
pulse.v1.EpicService, declared in pulse.proto.
| Method | Request → Response | Least role | Notes |
|---|---|---|---|
ListEpics | ListEpicsRequest → ListEpicsResponse | viewer | ListEpics lists the epics the caller owns or approves (one campaign, or all). |
DraftEpics | DraftEpicsRequest → ListEpicsResponse | editor | DraftEpics derives a campaign’s epics from its plan: a “deliver” epic for its objective (milestones = the roadmap’s phases) and, when the audit’s gaps cite measured findings, an “improve” epic on the site score with DMAIC gates. No model call; kinds the campaign already has are kept. |
UpdateEpic | UpdateEpicRequest → Epic | editor | UpdateEpic sets the target, its date, the approver and RACI (owner only). |
SetDoneCriterion | SetDoneCriterionRequest → Epic | editor | SetDoneCriterion adds, ticks or unticks a Definition-of-Done line (owner). |
ApproveMilestone | ApproveMilestoneRequest → Epic | editor | ApproveMilestone signs a gate off: the named approver only, and only once its exit criterion is met and its Definition of Done complete. |
ListApprovers | ListApproversRequest → ListApproversResponse | viewer | ListApprovers lists the people who may approve (editor or admin role), or everyone (for Consulted and Informed). |
Also uses RoadmapItem, Channel.
message ListEpicsRequest { string campaign_id = 1; }
message ListEpicsResponse { repeated Epic epics = 1; }
message DraftEpicsRequest { string campaign_id = 1; }
message UpdateEpicRequest {
string epic_id = 1;
bool target_set = 2; // false clears the target
double target = 3;
string target_date = 4; // YYYY-MM-DD, "" = none
string approver_user_id = 5;
repeated string responsible = 6;
repeated string consulted = 7;
repeated string informed = 8;
}
message SetDoneCriterionRequest {
string milestone_id = 1;
int32 index = 2; // -1 adds text as a new line
string text = 3;
bool done = 4;
}
message ApproveMilestoneRequest { string milestone_id = 1; }
message ListApproversRequest {
// true lists every person (for Consulted and Informed), not only those who
// may approve.
bool everyone = 1;
}
message ListApproversResponse { repeated Person people = 1; }
message Person {
string user_id = 1;
string name = 2; // display name; "" when the account has none
string role = 3; // editor | admin
}
message Epic {
string id = 1;
string campaign_id = 2;
string campaign_name = 3;
string kind = 4; // deliver | improve
string objective = 5; // the campaign's objective (deliver)
// leads | clicks | impressions | engagements | conversions | site_score
string kpi = 6;
KpiStatus kpi_status = 7;
Person owner = 8; // accountable
Person approver = 9; // unset when none is named
repeated Person responsible = 10;
repeated Person consulted = 11;
repeated Person informed = 12;
repeated Milestone milestones = 13;
EpicForecast forecast = 14;
ScheduleIndex schedule = 15;
bool you_own = 16;
bool you_approve = 17;
string target_date = 18;
}
message KpiStatus {
bool measured = 1; // false: nothing measures this KPI yet
double current = 2; // last 28 days (sum), or the latest score
bool baseline_set = 3;
double baseline = 4; // the value when the epic was drafted
bool target_set = 5;
double target = 6;
repeated KpiPoint series = 7;
ControlChart chart = 8; // improve epics
}
message KpiPoint { string date = 1; double value = 2; }
message ControlChart {
bool computed = 1;
// Why it was not computed: "few_points" ("" = computed); the client words
// it with reason_have of reason_need.
string reason = 2;
double mean = 3;
double ucl = 4;
double lcl = 5;
reserved 6; // was free-text signals
repeated ChartSignal signals = 7;
int32 reason_have = 8;
int32 reason_need = 9;
}
// One run-rule break of a control chart, over points from..to (1-based).
message ChartSignal {
// above_limit | below_limit | run_above_mean | run_below_mean
string kind = 1;
int32 from = 2;
int32 to = 3;
}
message EpicForecast {
bool computed = 1;
// Why it was not computed: few_weeks | few_completed | unreadable ("" =
// computed); the client words it with reason_have of reason_need.
string reason = 2;
int32 remaining_items = 3;
int32 history_weeks = 4;
int32 completed_in_history = 5;
string p50_date = 6;
string p85_date = 7;
string p95_date = 8;
int32 trials = 9;
int32 reason_have = 10;
int32 reason_need = 11;
}
message ScheduleIndex {
bool computed = 1;
int32 planned_to_date = 2;
int32 done_to_date = 3;
double spi = 4;
}
message Milestone {
string id = 1;
string gate = 2; // deliver: "phase"; improve: D | M | A | I | C
string title = 3; // the roadmap phase's name (deliver)
string due_date = 4;
bool threshold_set = 5;
double threshold = 6; // the KPI value the gate must reach
bool exit_met = 7; // threshold reached (or none set) and, for C, the chart in control
repeated DoneCriterion done_criteria = 8;
repeated RoadmapItem items = 9;
int32 items_done = 10;
// open | met | approved | missed
string status = 11;
Person approved_by = 12;
string approved_at = 13;
}
message DoneCriterion { string text = 1; bool done = 2; }AutopilotService
AutopilotService — PULSE runs a connected social account by itself AFTER a person approves the content (owner, 2026-10-29: “PULSE agents will autonomously manage our social media accounts once the content is approved”).
The rules a reader can rely on: * Approval is the human gate. Autopilot schedules only content a person approved, and the publishing worker checks the approval again on the row it is about to send. * PULSE_APPLY_ENABLED and the per-channel PULSE_PUBLISH_(channel) switches are the hard kill switches: autopilot never schedules on a disarmed channel and every send passes the same dispatch gate as a manual one. * An account pauses by itself on an expired connection, a rate limit or repeated failures, and says so in To do today with a reconnect link. * Replies to comments are drafted into an approval queue. Auto-reply is OFF by default and, when a person turns it on, covers only thanks, an answer from approved FAQ content and a link to the business’s own site; each auto-reply passes OpenBias and the plan gate and is logged. * Comments, mentions, DMs and results are read only where the connector provides them; elsewhere the account says PULSE cannot read them yet. * Everything is owner-scoped.
pulse.v1.AutopilotService, declared in autopilot.proto.
| Method | Request → Response | Least role | Notes |
|---|---|---|---|
ListAutopilotAccounts | ListAutopilotAccountsRequest → ListAutopilotAccountsResponse | viewer | |
SetAutopilot | SetAutopilotRequest → AutopilotAccount | editor | SetAutopilot turns autopilot on or off, pauses or resumes it, and sets the posting cadence, the auto-reply policy and the account’s UTC offset. |
ListEngagement | ListEngagementRequest → ListEngagementResponse | viewer | The reply approval queue (and what was already sent). |
DecideEngagementReply | DecideEngagementReplyRequest → EngagementItem | editor | |
GetWeeklySummary | GetWeeklySummaryRequest → WeeklySummary | viewer | “What PULSE did for you” this week, built from recorded rows only. |
EmailWeeklySummary | EmailWeeklySummaryRequest → EmailWeeklySummaryResponse | editor | Emails the summary to the person from their own mailbox (behind PULSE_APPLY_ENABLED + PULSE_PUBLISH_EMAIL). |
message ListAutopilotAccountsRequest {}
message ListAutopilotAccountsResponse {
repeated AutopilotAccount accounts = 1;
}
// BestTimeSlot is one weekday/hour PULSE posts at, in the account's own time.
message BestTimeSlot {
// 0 = Sunday … 6 = Saturday.
int32 weekday = 1;
int32 hour = 2;
// The median engagement (reactions + comments) of the posts measured in
// this slot; absent on PULSE's starting schedule.
optional double median_engagement = 3;
int32 posts = 4;
}
message BestTime {
// false: PULSE's starting schedule, not measured yet.
bool measured = 1;
repeated BestTimeSlot slots = 2;
// Posts with measured results the model was built from.
int32 posts_measured = 3;
// Posts needed before the schedule is measured.
int32 posts_needed = 4;
}
message AutopilotAccount {
// Integration platform key: linkedin, youtube, instagram.
string platform = 1;
// The content channel it posts, e.g. CHANNEL_LINKEDIN.
string channel = 2;
bool connected = 3;
bool enabled = 4;
bool paused = 5;
// auth | rate_limit | failures | person ("" when not paused).
string pause_kind = 6;
// Plain words, from what the platform said.
string paused_reason = 7;
google.protobuf.Timestamp paused_at = 8;
// The in-app address that fixes it, e.g. /settings?tab=integrations.
string reconnect_link = 9;
int32 posts_per_week = 10;
// board (the campaign board's items per week) | account (set here) |
// starting (PULSE's starting cadence).
string cadence_source = 11;
// Empty = auto-reply off (the default).
repeated string auto_reply_categories = 12;
bool reads_comments = 13;
// Why comments are not read, e.g. "PULSE can't read comments on YouTube yet".
string comments_note = 14;
BestTime best_time = 15;
// PULSE_APPLY_ENABLED AND the channel's own switch.
bool armed = 16;
string armed_reason = 17;
int32 utc_offset_minutes = 18;
google.protobuf.Timestamp next_post_at = 19;
int32 pending_posts = 20;
bool reads_results = 21;
// What PULSE can read on this account, per kind (results, comment,
// mention, dm): reads, not read yet, not available on the platform, not
// supported by PULSE yet, reconnect to allow, or unreadable.
repeated EngagementCapability capabilities = 22;
}
message SetAutopilotRequest {
string platform = 1;
optional bool enabled = 2;
// true pauses, false resumes.
optional bool paused = 3;
// 0 clears it (back to the board or the starting cadence).
optional int32 posts_per_week = 4;
// Applied only when set_auto_reply is true (a repeated field cannot say
// "unchanged"). Allowed: thanks, faq, hours_link.
repeated string auto_reply_categories = 5;
bool set_auto_reply = 6;
optional int32 utc_offset_minutes = 7;
}
message EngagementItem {
string id = 1;
string platform = 2;
// comment | mention | dm
string kind = 3;
string author = 4;
string text = 5;
string post_url = 6;
google.protobuf.Timestamp received_at = 7;
// waiting (a draft waits for approval) | not_drafted | sent | auto_sent |
// dismissed | failed | withheld
string status = 8;
string draft_reply = 9;
// thanks | faq | hours_link | other
string category = 10;
string reason = 11;
google.protobuf.Timestamp decided_at = 12;
string skill_id = 13;
// What OpenBias and the plan gate said about an auto-reply.
string gate_note = 14;
// DMs only: the end of the platform's reply window (Instagram: 24 hours
// after the person's last message). Unset for comments and mentions.
google.protobuf.Timestamp reply_by = 15;
}
message ListEngagementRequest {
// "" = everything waiting for a person; "all" = the log too.
string status = 1;
int32 limit = 2;
}
message ListEngagementResponse {
repeated EngagementItem items = 1;
// Platform keys of connected accounts PULSE cannot read comments on yet.
repeated string unreadable = 2;
// Per connected account and kind, what PULSE can read there.
repeated EngagementCapability capabilities = 3;
}
// EngagementCapability is what PULSE can read of one kind on one platform.
message EngagementCapability {
string platform = 1;
// results | comment | mention | dm
string kind = 2;
// reads | not_read_yet | not_available (the platform has no API for it,
// e.g. DMs on YouTube) | not_supported (PULSE cannot read it yet) |
// reconnect (a permission is missing) | unreadable (the last read failed)
string state = 3;
// Plain words: the reason, or what a reconnect would allow.
string note = 4;
// reconnect: the OAuth scopes / Meta permissions the connection lacks.
repeated string permissions = 5;
google.protobuf.Timestamp checked_at = 6;
}
message DecideEngagementReplyRequest {
string id = 1;
// true sends the reply (optionally edited); false dismisses it.
bool approve = 2;
string reply_text = 3;
}
message GetWeeklySummaryRequest {
// The week ending at this instant; unset = now.
google.protobuf.Timestamp until = 1;
}
message WeeklyNextPost {
string content_id = 1;
string title = 2;
string channel = 3;
google.protobuf.Timestamp at = 4;
}
message WeeklySummary {
google.protobuf.Timestamp from = 1;
google.protobuf.Timestamp until = 2;
int32 posts_published = 3;
int32 posts_withheld = 4;
int32 posts_failed = 5;
int32 replies_sent = 6;
int32 replies_auto_sent = 7;
int32 replies_drafted = 8;
// Sums over the posts whose results were measured; absent = not measured.
optional int64 reactions = 9;
optional int64 comments = 10;
optional int64 impressions = 11;
int32 posts_with_results = 12;
repeated WeeklyNextPost next = 13;
// Channels PULSE published on but cannot read results from.
repeated string not_measured = 14;
// The summary in plain words (the e-mail body).
string text = 15;
// Instagram / YouTube sums; absent = no post reported it.
optional int64 views = 16;
optional int64 reach = 17;
optional int64 saves = 18;
optional int64 shares = 19;
}
message EmailWeeklySummaryRequest {}
message EmailWeeklySummaryResponse {
// sent | withheld | failed
string status = 1;
string reason = 2;
string to = 3;
}AutomationService
AutomationService — Content › Automations: a person’s marketing automations, each ONE trigger and a graph of steps, drawn on the shared flow studio (org-runink/ui flow). The engine is ui’s flow/engine; every step calls an existing PULSE capability with the AUTOMATION OWNER’s identity and RBAC.
The rules a reader can rely on: * The model PROPOSES; the person APPROVES. The assistant’s propose_automation tool never changes an automation: it stores a pending proposal (plan-gated). Only DecideAutomationProposal(approve) applies it, and only against the graph it was proposed on. * An automation runs by itself only when ARMED (default off). Any change to what it runs disarms it. * A dry run shows what WOULD happen and changes nothing, sends nothing and spends no model time. * Every outbound step (schedule a post, a HubSpot write, an email, a call) also needs PULSE_APPLY_ENABLED=true, PULSE_PUBLISH_AUTOMATIONS and the step’s own channel switch and allowlists. * Everything is owner-scoped: another person’s automation, run, proposal or chat entry is NOT_FOUND.
pulse.v1.AutomationService, declared in automation.proto.
| Method | Request → Response | Least role | Notes |
|---|---|---|---|
ListAutomations | ListAutomationsRequest → ListAutomationsResponse | viewer | |
SaveAutomation | SaveAutomationRequest → Automation | editor | SaveAutomation creates (empty id) or updates name / nodes / edges. A change to what the automation runs disarms it. |
DeleteAutomation | DeleteAutomationRequest → google.protobuf.Empty | editor | |
SetAutomationArmed | SetAutomationArmedRequest → Automation | editor | SetAutomationArmed arms only a runnable automation (no problems). |
DryRunAutomation | DryRunAutomationRequest → AutomationRun | editor | |
RunAutomation | RunAutomationRequest → AutomationRun | editor | RunAutomation starts a live run now; refused unless armed. |
ListAutomationRuns | ListAutomationRunsRequest → ListAutomationRunsResponse | viewer | |
ListAutomationSteps | ListAutomationStepsRequest → ListAutomationStepsResponse | viewer | ListAutomationSteps says which step kinds can do their work on this server, and why not. |
ListAutomationProposals | ListAutomationProposalsRequest → ListAutomationProposalsResponse | viewer | Proposals are made by the floating assistant’s propose_automation tool (assistant_tool_defs.go), which keeps the conversation; the canvas lists and decides them. (ProposeAutomation, ListAutomationChat and DeleteAutomationChatEntry were removed on 2026-10-26 with the page’s own chat; their messages are gone, no field of a kept message changed.) |
DecideAutomationProposal | DecideAutomationProposalRequest → DecideAutomationProposalResponse | editor | |
ListAutomationTasks | ListAutomationTasksRequest → ListAutomationTasksResponse | viewer | Follow-up tasks the automations created. |
CompleteAutomationTask | CompleteAutomationTaskRequest → AutomationTask | editor | |
GetTargetAutomation | GetTargetAutomationRequest → Automation | editor | GetTargetAutomation returns the automation of one lead or one campaign item, creating it on first use from a default flow (a lead: first email, wait, follow-up, AI call, WhatsApp/SMS task; a campaign item: create the piece, approval, publish on its channel). It is created DISARMED. |
message AutomationNode {
string id = 1;
string kind = 2;
string label = 3;
map<string, string> config = 4;
double x = 5;
double y = 6;
}
message AutomationEdge {
string from = 1;
string to = 2;
string branch = 3;
}
message Automation {
string id = 1;
string name = 2;
bool armed = 3;
repeated AutomationNode nodes = 4;
repeated AutomationEdge edges = 5;
// What the automation runs (layout excluded); proposals are pinned to it.
string digest = 6;
// Why it cannot run yet; empty = runnable.
repeated string problems = 7;
google.protobuf.Timestamp updated_at = 8;
// Next firing of a schedule trigger, when armed.
google.protobuf.Timestamp next_fire_at = 9;
// What the automation belongs to: "lead" | "campaign_item" | "partner", and its id
// ("" = a free-standing automation).
string target_kind = 10;
string target_id = 11;
}
message ListAutomationsRequest {}
message ListAutomationsResponse { repeated Automation automations = 1; }
message SaveAutomationRequest {
string id = 1;
string name = 2;
repeated AutomationNode nodes = 3;
repeated AutomationEdge edges = 4;
}
message DeleteAutomationRequest { string id = 1; }
message SetAutomationArmedRequest {
string id = 1;
bool armed = 2;
}
message DryRunAutomationRequest {
string id = 1;
// The lead to try it on; empty = the trigger's own subjects, or the owner's
// most recent lead for a lead trigger (the run says which).
string lead_id = 2;
}
message RunAutomationRequest {
string id = 1;
string lead_id = 2;
}
message AutomationStepResult {
int32 seq = 1;
string node_id = 2;
string kind = 3;
// done | would | skipped | refused | failed | waiting
string status = 4;
string detail = 5;
repeated string subjects = 6;
google.protobuf.Timestamp at = 7;
}
message AutomationRun {
string id = 1;
string automation_id = 2;
bool dry_run = 3;
// running | waiting | done | failed | refused
string status = 4;
// The event that started it ("trigger.lead_created", "manual").
string trigger = 5;
repeated AutomationStepResult steps = 6;
google.protobuf.Timestamp started_at = 7;
google.protobuf.Timestamp finished_at = 8;
google.protobuf.Timestamp resume_at = 9;
string error = 10;
}
message ListAutomationRunsRequest {
string automation_id = 1;
int32 limit = 2;
}
message ListAutomationRunsResponse { repeated AutomationRun runs = 1; }
message ListAutomationStepsRequest {}
message ListAutomationStepsResponse { repeated AutomationStepKind steps = 1; }
message AutomationProposal {
string id = 1;
string automation_id = 2;
string summary = 3;
string rationale = 4;
string base_digest = 5;
repeated AutomationNode add_nodes = 6;
repeated AutomationNode update_nodes = 7;
repeated string remove_nodes = 8;
repeated AutomationEdge add_edges = 9;
repeated AutomationEdge remove_edges = 10;
// pending | approved | rejected
string status = 11;
// The plan gate dissented: kept for the record, cannot be approved.
bool withheld = 12;
runink.ui.judgement.v1.Judgement judgement = 13;
}
message ListAutomationProposalsRequest { string automation_id = 1; }
message ListAutomationProposalsResponse { repeated AutomationProposal proposals = 1; }
message DecideAutomationProposalRequest {
string proposal_id = 1;
bool approve = 2;
}
message DecideAutomationProposalResponse {
AutomationProposal proposal = 1;
Automation automation = 2;
}
message AutomationTask {
string id = 1;
string automation_id = 2;
string lead_id = 3;
string title = 4;
google.protobuf.Timestamp due_at = 5;
// open | done
string status = 6;
}
message ListAutomationTasksRequest { bool include_done = 1; }
message ListAutomationTasksResponse { repeated AutomationTask tasks = 1; }
message CompleteAutomationTaskRequest { string id = 1; }
message GetTargetAutomationRequest {
// lead | campaign_item | partner
string target_kind = 1;
string target_id = 2;
}MetricsService
Aggregated marketing metrics, daily evolution, channel distribution.
pulse.v1.MetricsService, declared in pulse.proto.
| Method | Request → Response | Least role | Notes |
|---|---|---|---|
GetMetricsSummary | GetMetricsSummaryRequest → MetricsSummary | viewer | GetMetricsSummary returns a high-level KPI dashboard. |
GetDailyEvolution | GetDailyEvolutionRequest → DailyEvolutionResponse | viewer | GetDailyEvolution returns time-series engagement data. |
GetChannelDistribution | GetChannelDistributionRequest → ChannelDistributionResponse | viewer | GetChannelDistribution returns per-channel metric breakdown. |
GetAgentReading | GetAgentReadingRequest → AgentReadingResponse | editor | GetAgentReading returns the AI’s interpretation of current metrics. |
GetWorkLedger | GetWorkLedgerRequest → WorkLedger | viewer | GetWorkLedger counts the work PULSE did for the caller in a range, from the rows it already keeps: no model call, no write. |
Also uses DateRange, Channel, MetricPoint.
message GetWorkLedgerRequest {
DateRange date_range = 1; // unset start or end = unbounded on that side
}
// WorkCount is one channel's count, by its stored name ("CHANNEL_LINKEDIN").
message WorkCount {
string channel = 1;
int64 count = 2;
}
// WorkLedger: what PULSE did, counted from real rows. Work PULSE does not
// record (calls placed, emails sent, fixes applied) is not here at all.
message WorkLedger {
// Pieces that went out in the range, per channel: a scheduled post marked
// posted, or a feed item (podcast, audiobook) published. Posts sent at the
// moment of approval are not recorded, so they are not counted.
repeated WorkCount published = 1;
// Drafts now approved or published whose last change falls in the range.
int64 drafts_approved = 2;
// Leads Find Leads or an audit saved in the range.
int64 leads_found = 3;
// Leads now past "new" (contacted, qualified, won or lost). The stage
// change time is not recorded, so this is today's count, not the range's.
int64 leads_moved_on = 4;
// Outreach drafts (email, call script, LinkedIn message) written in the range.
int64 outreach_drafts = 5;
// Follow-up tasks marked done in the range.
int64 tasks_done = 6;
// Drafts waiting for review now.
int64 awaiting_review = 7;
}
message GetMetricsSummaryRequest {
DateRange date_range = 1;
string campaign_id = 2; // optional filter
}
message MetricsSummary {
int64 total_followers = 1;
int64 total_impressions = 2;
int64 total_engagements = 3;
double engagement_rate = 4;
int64 total_clicks = 5;
int64 total_leads = 6;
double conversion_rate = 7;
int64 content_published = 8;
double follower_growth_rate = 9;
double reach = 10;
map<string, double> channel_scores = 11; // per-channel health score 0-100
// Days with any recorded metric in the range. 0 = nothing was measured,
// so the totals above are not measurements and must not be shown as 0.
int32 measured_days = 12;
// Google Ads cost in micros of spend_currency; conversions as Ads reports
// them. Each counts only when measured_fields names it ("spend",
// "conversions").
int64 total_spend_micros = 13;
double total_conversions = 14;
string spend_currency = 15;
// The totals measured on at least one day in the range: "followers",
// "impressions", "engagements", "clicks", "leads", "spend", "conversions".
// A total not listed is not measured, whatever its value.
repeated string measured_fields = 16;
}
message GetDailyEvolutionRequest {
DateRange date_range = 1;
repeated Channel channels = 2;
string metric_type = 3; // "followers", "engagement", "impressions", "leads"
}
message DailyEvolutionResponse {
repeated MetricPoint data_points = 1;
map<string, double> trend_slopes = 2; // per-channel trend direction
}
message GetChannelDistributionRequest {
DateRange date_range = 1;
}
message ChannelDistribution {
Channel channel = 1;
double percentage = 2;
int64 absolute_value = 3;
double growth_rate = 4;
// The stored channel ("web", "google_ads", "crm" …), which the Channel enum
// cannot name.
string channel_name = 5;
}
message ChannelDistributionResponse {
repeated ChannelDistribution distributions = 1;
}
message GetAgentReadingRequest {
DateRange date_range = 1;
string focus_area = 2; // "growth", "engagement", "content_performance", "overall"
}
message AgentReadingResponse {
string summary = 1;
repeated string key_insights = 2;
repeated string recommendations = 3;
double confidence = 4;
google.protobuf.Timestamp generated_at = 5;
// True when nothing was measured in the range: no model was asked.
bool not_measured = 6;
}AnalyticsService
Google Analytics (GA4) trend data + Prophet-style forecasting. SyncGaData pulls a metric’s daily time series from the configured GA4 property (see IntegrationService for how the service-account credential is stored) into the local ga_metrics cache. GetTrends reads that cache. GetForecast runs the Prophet-style decomposition forecaster (internal/forecast) over the cached series — no live GA call, so it’s fast and works even if GA is temporarily unreachable.
pulse.v1.AnalyticsService, declared in pulse.proto.
| Method | Request → Response | Least role | Notes |
|---|---|---|---|
SyncGaData | SyncGaDataRequest → SyncGaDataResponse | editor | SyncGaData pulls the latest daily metric values from GA4 into the local cache. |
GetTrends | GetTrendsRequest → GetTrendsResponse | viewer | GetTrends returns the cached historical daily time series for a metric. |
GetForecast | GetForecastRequest → GetForecastResponse | viewer | GetForecast runs Prophet-style forecasting over the cached time series. |
Also uses MetricPoint.
message SyncGaDataRequest {
string metric = 1; // GA4 metric API name, e.g. "sessions", "activeUsers", "conversions"
int32 lookback_days = 2; // defaults to 90 if unset
}
message SyncGaDataResponse {
int32 synced_count = 1;
google.protobuf.Timestamp synced_at = 2;
}
message GetTrendsRequest {
string metric = 1;
int32 days = 2; // defaults to 90 if unset
}
message GetTrendsResponse {
repeated MetricPoint points = 1;
string metric = 2;
// False when the caller has no Google Analytics connection: no points is
// then "not connected", an answer, not an error.
bool ga_connected = 3;
}
message GetForecastRequest {
string metric = 1;
int32 horizon_days = 2; // number of future days to forecast, defaults to 14
}
message GetForecastResponse {
repeated MetricPoint historical = 1;
repeated ForecastPoint forecast = 2;
repeated string anomalies = 3; // human-readable notes on historical anomalies
repeated google.protobuf.Timestamp changepoints = 4; // dates where the trend slope shifted
int32 season_period_days = 5; // 0 = no seasonality detected
// False when the caller has no Google Analytics connection.
bool ga_connected = 6;
// True when there are too few synced days to forecast: historical is set,
// forecast is empty. An answer, not an error.
bool too_few_days = 7;
}
// ForecastPoint is one future predicted value. Bounds are a simple ±2×
// residual-stddev band around the point estimate (see AnalyticsService's
// GetForecast handler) — not a full Bayesian credible interval, but enough
// to communicate forecast uncertainty visually.
message ForecastPoint {
google.protobuf.Timestamp date = 1;
double predicted_value = 2;
double lower_bound = 3;
double upper_bound = 4;
}GrowthPlanService
GrowthPlanService — the 90-day plan (owner, 2026-11-06: “qualified inbound leads and roadmap automation plans, road map and action plans for 90 days”). The spine of the console: made from the latest check-up, three 30-day phases (fix and foundations, publish and attract, convert and scale), weekly actions.
The rules a reader can rely on: * Every action comes from one finding of the check-up (a site-score fix, an AI-access failure, a buyer question the AI answers without the business, a missing Discover or retention item, a content gap’s campaign item, a lead the check-up found). An action without its finding is never made. * No model call. The plan is laid out in Go from what was measured. * Editing (accept, drop, move, owner) changes only the plan. Nothing the plan links to is created by the plan: a piece is still written and approved on the board, an email still waits for its send, a fix still goes through the site report. * KPIs are computed when read, from measured baselines only. A KPI with no source reads “not measured”, with the step that would measure it.
pulse.v1.GrowthPlanService, declared in growth_plan.proto.
| Method | Request → Response | Least role | Notes |
|---|---|---|---|
GetGrowthPlan | GetGrowthPlanRequest → GrowthPlan | viewer | GetGrowthPlan returns the caller’s active plan, with its progress and KPIs as measured now. exists=false when there is none yet. |
MakeGrowthPlan | MakeGrowthPlanRequest → GrowthPlan | editor | MakeGrowthPlan lays the plan out from the caller’s latest full check-up. A plan already made from that check-up is returned as is. A newer check-up makes a new plan that keeps the 90 days’ start and every edit made to an action with the same finding. |
UpdateGrowthAction | UpdateGrowthActionRequest → GrowthPlan | editor | UpdateGrowthAction accepts, drops, moves or re-owns one action. |
ReasonGrowthValues | ReasonGrowthValuesRequest → GrowthPlan | editor | ReasonGrowthValues reasons the plan’s targets, the inbound qualification bars and the outreach cadence again for the caller’s scenario: public benchmarks found by search, each cited with its URL and the date read, then the model (inside the loop’s daily cap). Runs detached; the plan says “reasoning” until it ends. A busy model keeps the last values. |
SetGrowthOverride | SetGrowthOverrideRequest → GrowthPlan | editor | SetGrowthOverride sets (value given) or clears (value unset) the person’s own figure for one reasoned value; the reasoning stays shown. |
SaveGrowthReview | SaveGrowthReviewRequest → GrowthPlan | editor | SaveGrowthReview records the weekly review of one week of the plan. |
message ReasonGrowthValuesRequest {}
message SetGrowthOverrideRequest {
string key = 1;
optional double value = 2; // unset clears the override
}
message SaveGrowthReviewRequest {
int32 week = 1;
string wins = 2;
string challenges = 3;
string notes = 4;
optional int32 satisfaction = 5; // 1..10
}
// One public benchmark a reasoned value rests on.
message BenchmarkSource {
string url = 1;
string title = 2;
string quote = 3; // the words the figure was read from
double figure = 4;
google.protobuf.Timestamp read_at = 5;
string query = 6; // the search that found it
}
// One step of the reasoning, with how sure it is.
message ReasonStep {
string text = 1;
string confidence = 2; // high | medium | low
}
// A value PULSE reasoned for this business: never a bare number. It carries
// its sources, or assumed=true ("assumed, no benchmark found") with low
// confidence.
message GrowthReasoned {
// traffic_growth | inbound_growth | reply_rate | meeting_rate | fit_bar |
// intent_bar | sequence_touches | sequence_gap_days
string key = 1;
double value = 2;
string unit = 3; // percent | points | touches | days
string confidence = 4; // high | medium | low
repeated ReasonStep steps = 5;
repeated BenchmarkSource sources = 6;
bool assumed = 7;
google.protobuf.Timestamp set_at = 8;
string by = 9; // model | rules
bool overridden = 10;
double override_value = 11;
google.protobuf.Timestamp overridden_at = 12;
double effective = 13; // the override when set, else value
string scenario = 14; // the business scenario it was reasoned for
}
// One week's review (the check-ins of the retired 30-day cycle move here).
message GrowthReview {
int32 week = 1;
string wins = 2;
string challenges = 3;
string notes = 4;
bool rated = 5; // false: no satisfaction given
int32 rating = 6; // satisfaction 1..10
google.protobuf.Timestamp created_at = 7;
bool from_check_in = 8; // migrated from a 30-day-cycle check-in
int64 posts_published = 9;
int64 leads = 10;
}
message GetGrowthPlanRequest {}
message MakeGrowthPlanRequest {}
message UpdateGrowthActionRequest {
string action_id = 1;
// proposed | accepted | done | dropped; unset = unchanged.
optional string status = 2;
// 1..13; unset = unchanged.
optional int32 week = 3;
// "you", "pulse", or a name; unset = unchanged.
optional string owner = 4;
}
message GrowthPlan {
// false: no plan yet. latest_run_id says whether one can be made.
bool exists = 1;
string id = 2;
string audit_run_id = 3;
string domain = 4;
google.protobuf.Timestamp checkup_at = 5;
google.protobuf.Timestamp start_date = 6;
// The week of the 90 days today falls in: 1..13; 0 before the start,
// 14 after the end.
int32 current_week = 7;
repeated GrowthPhase phases = 8;
repeated GrowthWeek weeks = 9;
repeated GrowthAction actions = 10;
// The caller's latest full check-up ("" = none: run one first).
string latest_run_id = 11;
google.protobuf.Timestamp latest_checkup_at = 12;
// True when latest_run_id is newer than the plan's check-up.
bool newer_checkup = 13;
// What PULSE reasoned for this business, and the state of that reasoning:
// "" never ran | running | done | kept (the model was busy or over its
// cap: the last values are kept, reasoning_note says why and since when)
// | failed.
repeated GrowthReasoned reasoned = 14;
string reasoning_state = 15;
string reasoning_note = 16;
google.protobuf.Timestamp reasoned_at = 17;
repeated GrowthReview reviews = 18;
// What the plan's caps left out of the check-up, one entry per kind that
// was cut. Empty = nothing was cut OR the plan was made before this field
// existed (the page cannot tell those apart, so it says nothing either way).
repeated GrowthCut cuts = 19;
}
// GrowthCut is one cap that left findings out of the plan: the check-up found
// more of this kind than the plan carries.
message GrowthCut {
// The kind: site_fix | ai_access | campaign_item | content_gap |
// unanswered_question | lead | discover | retention.
string source = 1;
// The most the plan carries of this kind.
int32 cap = 2;
// How many findings of this kind the check-up had beyond the cap.
int32 not_planned = 3;
}
message GrowthPhase {
int32 number = 1; // 1, 2, 3
string key = 2; // fix | attract | convert
int32 first_week = 3;
int32 last_week = 4;
google.protobuf.Timestamp starts = 5;
google.protobuf.Timestamp ends = 6;
int32 total = 7; // actions not dropped
int32 done = 8;
repeated GrowthKpi kpis = 9;
}
message GrowthWeek {
int32 week = 1;
google.protobuf.Timestamp starts = 2;
int32 total = 3; // actions not dropped
int32 done = 4;
}
// One KPI. Every figure is measured or absent; absent is never 0.
message GrowthKpi {
// site_score | published | traffic | qualified_inbound | replies | meetings
string key = 1;
bool measured = 2; // false: no baseline; why_not and connect say why
double baseline = 3;
// checkup_score | published_90d | ga_sessions_28d | inbound_90d | replies_90d
string baseline_basis = 4;
bool has_target = 5;
double target_value = 6;
// score_plus_fixes | baseline_plus_actions | quarter_above
string target_basis = 7;
bool has_current = 8;
double current_value = 9;
// latest_checkup | since_start | next_checkup (has_current false)
string current_basis = 10;
// Set when measured is false: no_score | ga_not_connected | ga_no_data |
// no_inbound_source | replies_not_tracked | unreadable
string why_not = 11;
string connect_route = 12; // the in-app page that would measure it
// The reasoned value the target follows from ("" = none: the target
// follows from the plan's own actions or the check-up).
string reasoned_key = 13;
}
message GrowthAction {
string id = 1;
int32 phase = 2;
int32 week = 3;
// fix | ai_access | answer | discover | publish | retention | lead
string kind = 4;
// What to do, in the finding's own words (a check's title, a question,
// a topic, a lead's name); the page puts the kind's verb before it.
string what = 5;
// Why: the finding's own evidence (a check's rationale and severity, a
// gap's rationale and opportunity, what the AI answer cited). Never empty.
string why = 6;
// site_score | ai_visibility | discover | retention | content_gap | audit_lead
string source_kind = 7;
string source_ref = 8;
string source_url = 9;
string owner = 10; // you | pulse | a name
string status = 11; // proposed | accepted | done | dropped
// Done because the data shows it (published, contacted, the check passed
// at a later check-up), with how; false = the person's own tick or not done.
bool done_measured = 12;
string done_basis = 13;
GrowthAutomation automation = 14;
// What it drives: fix | campaign_item | campaign | lead | report
string target_kind = 15;
string target_id = 16;
string link = 17; // in-app route that opens it
bool edited_by_hand = 18;
}
// The automation an action runs on: the existing per-target automations
// (AutomationService.GetTargetAutomation) or the site report's ready fix.
message GrowthAutomation {
// lead_outreach | content_item | site_fix | none
string kind = 1;
string target_kind = 2; // lead | campaign_item | "" (none)
string target_id = 3;
}