Skip to content

Fix Automations docs drift: job palette claim, run-time args, Configure tab, history card#790

Merged
selfcontained merged 1 commit into
mainfrom
agt_77e2e787ae18/job-doc-ter-bdfd86a1
Jul 17, 2026
Merged

Fix Automations docs drift: job palette claim, run-time args, Configure tab, history card#790
selfcontained merged 1 commit into
mainfrom
agt_77e2e787ae18/job-doc-ter-bdfd86a1

Conversation

@selfcontained

Copy link
Copy Markdown
Owner

Nightly docs audit — deep-dive on the in-app Automations docs section (Jobs + Templates) against the current forms, trigger types, and run lifecycle.

Audited

  • Template create fields (automations-form-fields.tsx) — all accurate, including terminal-type field skipping, allowMedia default, and launch flows.
  • Job create dialog + Configure tab (jobs-add-dialog.tsx, jobs-settings-tab.tsx) — fields, defaults (30 min run timeout, 24 h wait-for-input), webhook trigger.
  • Run lifecycle tools/statuses, trigger source labels (Manual/Scheduled/Webhook), job-agent tool lists (already refreshed by Unify persona reviews with feedback threads #782), state-across-runs, Automations UI tabs.

Fixed

  • "Show in command palette" (jobs) — docs claimed callable jobs appear in the ⌘K palette. That was removed in the Add agent templates — split quick-launch from job automation #515 template split; callable jobs now only get a badge in the jobs list. Reworded to match actual behavior. Note: the form toggle copy still says "Launch this job from the ⌘K palette" — this is a UI regression worth a product decision (restore palette entries or drop the toggle); flagged in the audit backlog.
  • Job prompt arguments — docs said placeholders work "just like templates". Jobs never collect args at run time; {{D:...}} is only substituted from API-saved defaultArgs. Also tightened the preamble claim (it includes job/run IDs, not the job name).
  • "Settings" tab → the job detail tab is labeled Configure.
  • History and status — job cards don't show finished time or next fire time; they show status + schedule + enabled state, with upcoming runs on the Jobs overview and per-run detail in History.

Added

  • Ambient tip job-webhook-trigger (since 0.29.0) — webhook triggers are buried in the job Configure tab and easy to miss.

Deferred

🤖 Generated with Claude Code

…istory 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 <[email protected]>
@selfcontained
selfcontained merged commit 4d2bede into main Jul 17, 2026
1 check passed
@selfcontained
selfcontained deleted the agt_77e2e787ae18/job-doc-ter-bdfd86a1 branch July 17, 2026 04:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant