docs: custom workflow status mapping parity across PM providers

[aaight]

Summary

Documents the custom workflow status mapping support shipped for Trello, JIRA, and Linear (MNG-1064/1065/1066/1067) so operators have a clear setup story and contributors know the provider parity contract.

https://linear.app/issue/MNG-1068

Changes

• docs/architecture/04-agent-system.md — adds a Custom workflow statuses across PM providers subsection that explains the two-part contract (status definition in code/DB + provider-native mapping in integration config), lists each provider's dispatch path (TrelloCustomStatusChangedTrigger, JiraStatusChangedTrigger, LinearStatusChangedTrigger), and states the dispatch precondition that statuses without agentType render and save but do not dispatch.
• docs/architecture/08-config-credentials.md — adds a Custom workflow status mappings subsection with the per-provider native value table (Trello lists.<customKey>, JIRA statuses.<customKey>, Linear statuses.<customKey>), the lifecycle-resolver spread requirement, and the auto-create-trigger-config behavior on wizard save.
• docs/architecture/09-database.md — adds the missing workflow_status_definitions table and workflowStatusDefinitionsRepository entries.
• docs/getting-started.md — adds a Map a custom workflow status operator walkthrough under step 10 (Configure Triggers): register with cascade workflow-statuses create, map in the wizard's Status Mapping step, and verify with cascade projects trigger-list / dashboard Agent Configs tab. Documents the render-only path for statuses without --agent-type.
• src/integrations/README.md — adds the Custom workflow status — provider parity contract section: where each concern lives (status definition table vs provider-native mapping), wizard path (trpc.workflowStatuses.list + StatusMappingStep + buildMissingStatusTriggerConfigs), dispatch path (shared resolvePMStatusAgentFromWorkflowDefinitions), and a four-item checklist a new PM provider must implement for parity.

All four files cross-reference each other through relative ./*.md links, and the agentType: null render-but-don't-dispatch invariant is stated consistently in every file.

Test plan

• npx vitest run --project unit-core tests/unit/architecture-docs.test.ts — passes (41 tests, including the relative-link guard that now covers the new cross-references).
• npx vitest run --project unit-core tests/unit/integrations/ — passes (258 tests including pm-conformance harness).
• npm run typecheck — passes.
• Verified each doc claim against the actual implementation (buildMissingStatusTriggerConfigs, TrelloCustomStatusChangedTrigger, resolvePMStatusAgent*FromWorkflowDefinitions, LinearIntegration.resolveLifecycleConfig spread pattern).

🕵️ claude-code · claude-opus-4-7 · run details

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[nhopeatall]

LGTM - the documentation matches the shipped custom workflow status behavior across Trello, JIRA, and Linear. I verified the CLI examples, provider-native storage shapes, lifecycle status spreading, shared wizard save helper, and PM trigger dispatch/resolver paths; the architecture-docs unit test also passes locally.

🕵️ codex · gpt-5.5 · run details