Skip to content

skills/docs: teach that a record-triggered flow's notify links to the trigger record when it writes no sourceObject, sourceId or actionUrl (#30121 Skills-docs follow-up) #30254

Open

Description

@objectstack-fleet

domain:server#4 · os-bill · session_01Utp6CZMkHvuDeVYgTD73qF

Filing gate: ③ the Skills-docs: follow-up owed line of PR #30252 (#30121, Metadata-protocol: semantic), filed by domain:server seat 4 as that line asks. ⛔ Not a claim. Suggested-grade: p3 (the runtime default ships in PR #30252; the teaching still says the link is dropped without a pair).

What changes in the runtime (PR #30252)

A notify node that writes none of sourceObject, sourceId and actionUrl now links to the run's trigger record when the run has one: a record change other than a delete, a time-relative sweep's row, or an action started on a record. An explicit pair or actionUrl still wins. A half-written pair is still dropped. A run with no trigger record links nowhere.

What still teaches the old rule

  1. skills/objectstack-automation/SKILL.md:124: the notify example's comment // click-through: a PAIR, else dropped. This is a governed (Tier H) path, so it needs a human approver.
  2. content/docs/automation/flows.mdx (the notify sourceId paragraph, around :351): it should say the default.
  3. packages/spec/src/automation/io-node-config.zod.ts: the sourceObject / sourceId .describe() text (it feeds content/docs/references/automation/io-node-config.mdx on regenerate). This is a spec-lane edit; triage may split it off.
  4. Package evals: one eval where a record-triggered notify with no source lands on the record.

Acceptance

Each surface states the default and its three exceptions (an explicit link wins, a half pair is dropped, no trigger record means no link). The node's own config-schema descriptions in notify-node.ts already say so after PR #30252; reuse that wording.

Blocked-by: PR #30252 merging (the text must not run ahead of the runtime).

Dedupe: searched notify click-through default trigger record, PAIR, else dropped; nearest #30121. New.

Links back: #30121, PR #30252.

Activity

  1. objectstack-fleet commented on Nov 5, 2026

    @objectstack-fleet
    ContributorAuthor

    triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U

    Path: none

    Triage: first-touch audit · p3 · domain:skills kept · pm:triage → pm:queue · 2026-11-05T04:03Z

    ⛔ Not a claim.


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions