[rig-header] Update rig.ts agentic file-summary header (35bd710 → 33f6959)

[github-actions]

Updates the agentic file-summary header in skills/rig/rig.ts to reflect commit 33f6959.

What changed

The previous header (@last-analyzed 35bd710) was missing the entire workflow orchestration system introduced in the codebase. This PR adds documentation for all new exports.

New exports ([NEW] symbols)

Symbol	Kind	Description
WorkflowSpec<I,O>	type	workflow declaration {meta,input,body(ctx)}
Workflow<I,O>	type	compiled workflow object with meta, inputSchema, body
WorkflowContext<I>	type	ambient run context with call, pipeline, parallel, until, phase, log, budget, signal
WorkflowCall	type	callable fn + .text()/.json()/.workflow() for agent invocation inside workflow
WorkflowMeta	type	{name,description,phases?,whenToUse?}
WorkflowEvent	type	union of run/phase/agent/log/warning events
WorkflowLimits	type	{concurrency?,maxAgents?,maxWallMs?,warnAgents?}
WorkflowBudget	type	token-free agent-call budget meter
RunWorkflowOptions<I>	type	{args?,limits?,onEvent?,signal?}
WorkflowLimitError	class	thrown when WorkflowLimits exceeded
UntilOptions	type	{max,noProgressRounds?}
PipelineStage	type	pipeline step signature
workflow(spec)	function	compiles WorkflowSpec → Workflow
runWorkflow(wf,opts?)	function	runs a Workflow with limits, events, abort
currentWorkflow()	function	returns ambient WorkflowContext via AsyncLocalStorage
phase(name)	function	sets ambient workflow phase
log(message)	function	emits structured log event
parallel(tasks)	function	runs async tasks concurrently
pipeline(items,...stages)	function	runs pipeline stages over items
until(options,step)	function	loops step until done or max rounds

Metrics

• old_lines: 93
• new_lines: 100
• changed_lines: ~40 (all new workflow entries + updated SHA/timestamp/deps/purpose)
• change_ratio: ~0.43
• has_new_api: true

Also updated:

• @last-analyzed tag: 35bd710 → 33f6959
• @edit-time: 2026-07-29T10:33:46Z → 2026-07-31T03:16:04Z
• @deps: added async_hooks (used by AsyncLocalStorage for workflow context)
• @purpose: added "workflow orchestration"

Generated by Daily Rig Header Updater · sonnet46 52.7 AIC · ⌖ 6.65 AIC · ⊞ 6.3K · ◷

[github-actions]

🧠 Matt Pocock Skills Reviewer has completed the skills-based review. ✅

[github-actions]

Skills-Based Review 🧠

Applied /grill-with-docs — requesting one fix for a factual inaccuracy in the new PipelineStage entry.

📋 Key Themes & Highlights

Issue

• Inaccurate parameter name in PipelineStage: The header documents the signature as (prev,item,next)=>Promise<next>, but the third parameter in the actual type is index: number. Using next implies a continuation-style callback rather than an array index.

Positive Highlights

• ✅ Comprehensive coverage of all new workflow exports
• ✅ Clean removal of [NEW] tags from now-stable items
• ✅ async_hooks correctly added to @deps
• ✅ Compact condensing of p.* entries improves header scannability
• ✅ INV:workflow-context invariant note is a useful addition

🧠 Reviewed using Matt Pocock's skills by Matt Pocock Skills Reviewer · sonnet46 37.2 AIC · ⌖ 4.15 AIC · ⊞ 6.3K
_{Comment /matt to run again}

[github-actions]

[/grill-with-docs] Inaccurate signature: (prev,item,next)=>Promise<next> — the third parameter is index: number, not next.

💡 Correction

The actual type definition is:

export type PipelineStage<Previous, Item, Next> = (
  previous: Previous,
  item: Item,
  index: number,
) => Promise<Next> | Next;

Suggested header entry:

* T:PipelineStage type (prev,item,index)=>Promise<Next> pipeline step [NEW]

Using next as a parameter name implies a Node.js-style continuation callback, when it is actually a numeric array index. This will mislead authors reading the header as a primary usage reference.