From 2582126b0d8e9685f20576e5da59e4f9ac240aef Mon Sep 17 00:00:00 2001
From: Brad Harris <bmharris@gmail.com>
Date: Thu, 16 Jul 2026 22:09:32 -0600
Subject: [PATCH] Fix Automations docs drift: job palette claim, args,
 Configure tab, history card

- Jobs no longer appear in the Cmd+K palette (removed in the #515
  template split); reword the 'Show in command palette' bullet to match
  actual behavior (callable badge only).
- Job prompts never collect arguments at run time; placeholders are only
  substituted from API-saved default values. Preamble wording tightened
  (it includes job/run IDs, not the job name).
- Job detail tab is labeled Configure, not Settings.
- Sidebar job cards show status + schedule + enabled state, not finished
  time or next fire time; the Jobs overview lists upcoming runs.
- Add ambient tip for job webhook triggers.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../app/docs-sections/automations.tsx         | 35 +++++++++++--------
 apps/web/src/lib/tips/tips.ts                 |  8 +++++
 2 files changed, 29 insertions(+), 14 deletions(-)

diff --git a/apps/web/src/components/app/docs-sections/automations.tsx b/apps/web/src/components/app/docs-sections/automations.tsx
index 78589122..c4bc11d8 100644
--- a/apps/web/src/components/app/docs-sections/automations.tsx
+++ b/apps/web/src/components/app/docs-sections/automations.tsx
@@ -187,14 +187,18 @@ export function AutomationsContent() {
           </li>
           <li>
             <strong>Prompt</strong> — the instructions sent as the agent's first
-            message. Supports <Code>{"{{D:Arg Name}}"}</Code> placeholders just
-            like templates. Dispatch prepends a short preamble that names the
-            job, includes the run ID, and reminds the agent to drive the run to
-            a terminal state. Required before a run can start.
+            message. Dispatch prepends a short preamble that identifies the job
+            and run and reminds the agent to drive the run to a terminal state.
+            Required before a run can start. Unlike templates, jobs never
+            collect arguments at run time — <Code>{"{{D:Arg Name}}"}</Code>{" "}
+            placeholders are only substituted from default values saved via the
+            API.
           </li>
           <li>
-            <strong>Show in command palette</strong> — when on, the job appears
-            in the <Code>Mod+K</Code> palette for quick launch.
+            <strong>Show in command palette</strong> — marks the job as
+            callable, shown as a badge in the jobs list. Quick launch from the{" "}
+            <Code>Mod+K</Code> palette is currently only available for
+            templates.
           </li>
           <li>
             <strong>Single instance</strong> — when on (the default), only one
@@ -233,10 +237,11 @@ export function AutomationsContent() {
           </li>
         </ul>
         <P>
-          After creating a job, open its <strong>Settings</strong> tab to
-          configure additional options like <strong>Webhook trigger</strong> —
-          enable it to generate a secret URL that fires a run via HTTP POST. No
-          auth header is needed; the secret in the URL is the credential.
+          After creating a job, open its <strong>Configure</strong> tab to
+          adjust these settings and options like{" "}
+          <strong>Webhook trigger</strong> — enable it to generate a secret URL
+          that fires a run via HTTP POST. No auth header is needed; the secret
+          in the URL is the credential.
         </P>
       </Section>
 
@@ -391,10 +396,12 @@ export function AutomationsContent() {
       <Section>
         <H3>History and status</H3>
         <P>
-          Each job card shows the last run's status, when it finished, and the
-          next scheduled fire time. Open the <strong>History</strong> tab on a
-          job to browse past runs with their reports, durations, and trigger
-          source (Manual, Scheduled, or Webhook).
+          Each job in the sidebar list shows its last run's status alongside its
+          schedule and enabled state, and the Jobs overview (shown when no job
+          is selected) lists upcoming scheduled runs. Open the{" "}
+          <strong>History</strong> tab on a job to browse past runs with their
+          start time, duration, trigger source (Manual, Scheduled, or Webhook),
+          and expandable report.
         </P>
       </Section>
 
diff --git a/apps/web/src/lib/tips/tips.ts b/apps/web/src/lib/tips/tips.ts
index 76f26210..b4b31244 100644
--- a/apps/web/src/lib/tips/tips.ts
+++ b/apps/web/src/lib/tips/tips.ts
@@ -196,6 +196,14 @@ export const tips: Tip[] = [
     since: "0.27.0",
     surfaces: ["ambient"],
   },
+  {
+    id: "job-webhook-trigger",
+    title: "Job Webhook Triggers",
+    body: "Fire a job from CI or any external system: enable Webhook trigger in the job's Configure tab to get a secret URL that starts a run on HTTP POST.",
+    docsSection: "automations",
+    since: "0.29.0",
+    surfaces: ["ambient"],
+  },
 ];
 
 export function getTipById(id: string): Tip | undefined {