Keep the action builder aligned with deployed applications

Purpose

Applications keep a common action catalogue current so configuration uses the actions the deployed code supports.

How It Works

An application deploy publishes the triggers it raises and the actions it offers. Platform validates and reconciles those declarations in a shared registry. Builders read the available choices for their host and trigger context. Retired type detail remains available to explain existing configuration. Platform contributes shared timers and its own action declarations. Deployment setup also refreshes shipped recipes and cross-application views. A notification-centre action stays unavailable while its dependency is absent. The product should keep catalogue availability separate from proof that every host actually raises its events and executes those actions.

Relationships

Connects with reuse workflow recipes and working-time configuration through shared integration records.
Connects with publish event-driven automation and follow its work through shared integration records.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes: Builder choices follow the applications’ declarations.Conflicting application ownership is refused.
Surfaces: apijob
Intent sources: services-platform:docs/proposals/application-processes-and-workflow-actions/14-decisions.md#D-03

Controls

31 controls apply, from the corpus control catalogue.

TC-AVL-001 TC-AVL-004 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-CHG-001 TC-CHG-002 TC-CHG-003 TC-CHG-004 TC-CHG-005 TC-CHG-006 TC-DAT-004 TC-IAM-001 TC-IAM-006 TC-LOG-001 TC-LOG-004 TC-LOG-005 TC-MON-001 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-004 TC-PI-005 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

Key	Checked at	Scope
`platform.workflow-actions.registry-register`	service	tenant
`platform.workflow-actions.registry-read`	api	tenant

Business Rules

7 rules, 7 to be proved before approval. A rule's product intent is derived from its origin: 2 confirmed by a product decision, the rest inheriting this capability's proposed.

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Confirmed	Only a registered active application principal may submit its own declaration over the service boundary; foreign, unknown, suspended and web-person callers are refused without registry writes. origin: services-platform:docs/proposals/application-processes-and-workflow-actions/14-decisions.md#D-03 proved by `ATS-PFM-INT-018-01`, `TST-PFM-INT-586`, `TST-PFM-INT-603`	permission	service	test services-platform:modules/workflow-actions/tests/e2e/workflow-actions-registry.e2e.spec.js#answers 403 to another application’s principal registering CRM
`02`must prove Proposed	Malformed manifests identify all validation problems, and ownership, host, execution-kind or lowered-contract conflicts refuse the entire registration without partial writes. proved by `ATS-PFM-INT-018-02`, `TST-PFM-INT-586`, `TST-PFM-INT-603`	validation	service	test services-platform:modules/workflow-actions/tests/integration/services/registry/register-manifest.integration.spec.js#refuses a key another application registered (409)
`03`must prove Confirmed	Accepted registration inserts or updates entries, preserves unchanged entries, revives re-declared retired entries and retires omitted active entries, reporting counts and retired keys. origin: services-platform:docs/proposals/application-processes-and-workflow-actions/14-decisions.md#D-03 proved by `ATS-PFM-INT-018-03`, `ATS-PFM-INT-018-06`, `TST-PFM-INT-586`, `TST-PFM-INT-603`	lifecycle	service	test services-platform:modules/workflow-actions/tests/integration/services/registry/register-manifest.integration.spec.js#retires what is absent, and answers its keys
`04`must prove Proposed	Platform registers the automation event point, three universal timer points and five action types including communications, keeping the declared notification-centre action inactive until that facility exists. no proof recorded yet	policy	service	test services-platform:modules/workflow-actions/tests/integration/services/registry/ensure-platform-registry.integration.spec.js#declares notifications.notify and keeps it switched off
`05`must prove Proposed	Builder reads return a host’s own triggers and universal timers plus active action types configurable at the requested trigger, omit inactive types and still return retired type detail marked retired. proved by `ATS-PFM-INT-018-04`, `ATS-PFM-INT-018-07`, `ATS-PFM-INT-018-08`, `TST-PFM-INT-587`	policy	api, service	test services-platform:modules/workflow-actions/tests/e2e/workflow-actions.e2e.spec.js#lists the types configurable at a trigger, the switched-off one left out
`06`must prove Proposed	Workflow registry tables contain shared declarations without workspace ownership, with this module as their writer; access grants for other application roles remain documented evidence outside this examination boundary. no proof recorded yet	invariant	database	observed services-platform:modules/workflow-actions/db/trigger-points.table.ts:triggerPoints
`07`must prove Proposed	Platform setup applies declarations, updates shipped recipes, deactivates omitted shipped templates and rebuilds shared views from available host schemas. proved by `ATS-PFM-INT-018-05`	lifecycle	service	observed services-platform:modules/workflow-actions/services/registry/ensure-platform-registry.ts:ensurePlatformWorkflowActions

Scenarios

Id	Given	When	Then	Provenance
`01`	CRM removes an old task action from its deployed declaration.	The deployment replaces its registry fragment.	Registration reports the retired action while retaining the remaining entries.	test services-platform:modules/workflow-actions/tests/e2e/workflow-actions-registry.e2e.spec.js#retires what its next manifest no longer declares, and answers the keys

Planning

Implementation

Keep the action builder aligned with deployed applications ​

Purpose ​

How It Works ​

Relationships ​