fix(spec): stop routing automation authors at the ADR-0020-retired state machine

The published `objectstack-automation` index pointed at
`automation/state-machine.zod.ts`. ADR-0020 retired that shape AS A
RECORD-LIFECYCLE DECLARATION -- the top-level `workflow` metadata type and
`object.stateMachines` are both gone -- and a record's legal transitions are
now a `state_machine` validation rule in `data/validation.zod.ts`, which was
already the last entry of the same list. So the index did not merely
over-promise: it pointed at something the platform deliberately removed from
this package's surface. The file's one surviving door is `ai/agent.zod.ts`'s
`lifecycle`, an objectstack-ai door, and that index reaches it transitively.

The other direction, from the same audit: the two per-node-type `config`
schemas the body teaches were in no package's list at all. Screen `fields` and
the ADR-0031 loop/parallel/try_catch containers reach
`automation/builtin-node-config.zod.ts`; `NotifyConfigSchema` and the `http`
`timeoutMs` reach `automation/io-node-config.zod.ts`. An agent told to always
read the source for exact field shapes had no route to either.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01H2oQebDDxYKfWZusyd8GXk

Author: claude

packages/spec/scripts/build-skill-references.ts

@@ -128,10 +128,23 @@ const SKILL_MAP: Record<string, string[]> = {
     'automation/flow.zod.ts',
     'automation/time-relative-trigger.zod.ts',
     'automation/approval.zod.ts',
-    'automation/state-machine.zod.ts',
+    // `automation/state-machine.zod.ts` left this list: ADR-0020 retired that
+    // shape AS A RECORD-LIFECYCLE DECLARATION (the top-level `workflow` type
+    // and `object.stateMachines` are both gone), and a record's legal
+    // transitions are now a `state_machine` VALIDATION RULE — `data/validation`
+    // below, already the correct destination. The file's one surviving door is
+    // `ai/agent.zod.ts`'s `lifecycle`, an objectstack-ai door, and that index
+    // reaches it transitively. Advertising it here pointed automation authors
+    // at a shape the platform deliberately removed from their surface.
     'automation/execution.zod.ts',
     'automation/webhook.zod.ts',
     'automation/node-executor.zod.ts',
+    // The per-node-type `config` shapes the body teaches and the index did not
+    // name: screen `fields` and the ADR-0031 loop/parallel/try_catch containers
+    // reach `builtin-node-config`, `NotifyConfigSchema` and the `http`
+    // `timeoutMs` reach `io-node-config`.
+    'automation/builtin-node-config.zod.ts',
+    'automation/io-node-config.zod.ts',
     'data/validation.zod.ts',
   ],
   'objectstack-ui': [

skills/objectstack-automation/references/_index.md

@@ -10,10 +10,11 @@ from `node_modules` — there is no local copy in the skill bundle.
 ## Core schemas
 
 - `node_modules/@objectstack/spec/src/automation/approval.zod.ts` — Exports: ApproverType, ApprovalDecision, ApprovalNodeApproverSchema, DecisionOutputDefSchema, ApprovalEscalationSchema
+- `node_modules/@objectstack/spec/src/automation/builtin-node-config.zod.ts` — Config contracts for the remaining flat builtins — the CRUD quartet
 - `node_modules/@objectstack/spec/src/automation/execution.zod.ts` — Automation Execution Protocol
 - `node_modules/@objectstack/spec/src/automation/flow.zod.ts` — Exports: FlowNodeAction, FlowVariableSchema, FlowNodeSchema, FlowEdgeSchema, FlowSchema
+- `node_modules/@objectstack/spec/src/automation/io-node-config.zod.ts` — Config contracts for the flat IO builtins — `notify` and `http` (#4045).
 - `node_modules/@objectstack/spec/src/automation/node-executor.zod.ts` — Node Executor Plugin Protocol — Wait Node Pause/Resume
-- `node_modules/@objectstack/spec/src/automation/state-machine.zod.ts` — XState-inspired State Machine Protocol — hierarchical states, guarded
 - `node_modules/@objectstack/spec/src/automation/time-relative-trigger.zod.ts` — Time-Relative Trigger Protocol
 - `node_modules/@objectstack/spec/src/automation/webhook.zod.ts` — Exports: WebhookTriggerType, WebhookSchema
 - `node_modules/@objectstack/spec/src/data/validation.zod.ts` — ObjectStack Validation Protocol