feat(006/4): linear migrated — all PM providers now on manifest

[zbigniewsobiecki]

Summary

Plan 006/4 of spec 006: Linear is the third and final PM provider migrated onto the manifest pattern. All three providers (Trello, JIRA, Linear) are now on the manifest.

No operator-visible changes. Every PM wizard, webhook flow, trigger dispatch, and ack-comment path is byte-for-byte identical to dev.

What's landed

Backend

• src/integrations/pm/linear/manifest.ts — wires LinearIntegration, LinearRouterAdapter, 3 Linear trigger handlers, LinearPlatformClient. Uses the shared makeHmacSha256Verifier({ headerName: 'linear-signature' }) factory — no prefix.
• src/integrations/pm/index.ts — appends the Linear barrel import.
• src/triggers/builtins.ts — registerLinearTriggers call gone. Every PM provider contributes triggers via manifest iteration. SCM (GitHub) + alerting (Sentry) stay on legacy per spec scope.
• src/router/worker-env.ts::extractProjectIdFromJob — Linear branch removed. The function now has zero PM-specific branches — everything flows through extractProjectIdFromJobViaRegistry.

Shared-helper adoption (collapses the divergent copies that shipped production incidents)

• src/router/platformClients/linear.ts — switched to linearAuthHeader from _shared/auth-headers. In-file Authorization construction deleted.
• src/router/bot-identity-resolvers.ts — same adoption. Both call sites now impossible to diverge from the canonical helper.
• src/pm/linear/adapter.ts::resolveLabelId — delegates to _shared/label-id-resolver.resolveLabelId. Private helper + UUID_PATTERN constant deleted. Single source of truth for the UUID-validation rule that lost cascade-processing labels.

Frontend

• web/src/components/projects/pm-providers/linear/wizard.ts — linearProviderWizard composes useLinearDiscovery + useLinearLabelCreation inside useProviderHooks, plus the creatingSlot state + onCreateLabel / onCreateAllMissingLabels handlers using LINEAR_LABEL_DEFAULTS.
• web/src/components/projects/pm-wizard.tsx — With all 3 providers on the manifest, the non-manifest fallback path is deleted entirely. Every PM provider renders via <ManifestProviderWizardSection>. The parent wizard no longer owns any provider-specific React hooks, ephemeral state, or handlers. Three state.provider === '...' branches collapse to clean single-path renders.

Tests

• 7808 / 7808 tests pass
• 15 new Linear manifest tests
• Conformance harness now runs 44 assertions (11 × TestProvider + Trello + JIRA + Linear) — the entire spec AC chore: add .nvmrc for Node.js 22 #2 ("harness exercises every registered provider") is now fully delivered
• Existing Linear unit + integration tests all green unchanged

Lint + typecheck + backend build + web build all clean.

Deferred to plan 006/5 (same pattern as 006/2, 006/3)

• Removing every PM provider from src/integrations/bootstrap.ts. The ~dozen pmRegistry.get('trello' | 'jira' | 'linear') call sites (webhook handlers, manual runners, credential scoping, lifecycle) need migration to pmProviderRegistry.get(id)?.pmIntegration. Plan 006/5 does this atomically.
• Consolidating createLinearLabel / createLinearLabels (and Trello/JIRA equivalents) into pm.discovery.createLabel. Additive, not behavior-changing.

After this PR merges

Spec AC coverage:

• AC build(deps): Bump esbuild, @vitest/coverage-v8 and vitest #1 (drop-in provider folders) — ✅ full for all 3 providers (plus the TestProvider reference)
• AC chore: add .nvmrc for Node.js 22 #2 (harness exercises every registered provider) — ✅ full (44 assertions across 4 providers)
• AC chore: update llmist and zangief dependencies #3 (zero regressions) — ✅ full for all 3 providers
• AC Improved performance and stability #4 (canonical cross-cutting logic) — ✅ full (all divergent Linear auth/label copies deleted; makeHmacSha256Verifier consumed by JIRA + Linear + TestProvider)
• AC feat: add UpdateChecklistItem gadget and improve agent workflow #5 (wizard adapts from manifest registry) — ✅ full for all 3 providers
• AC chore: sync dev to main #6 (independently revertable) — ✅ verified by construction
• AC ci: add GitHub Actions for CI and Fly.io deployment #7 (author's guide rewritten) — partial, waiting on 006/5 transitional-note removal

Post-merge verification

• Local: full npm test green; lint + typecheck + backend build + web build all clean
• After deploy-dev: exercise the Linear wizard end-to-end — team selection, status mappings, label creation via "Create All Missing", save. Byte-for-byte identical expected.
• Trigger a Linear webhook (status change, comment mention, label added) and confirm agent dispatch fires via the manifest path.

🤖 Generated with Claude Code

[codecov]

Codecov Report

❌ Patch coverage is 98.07692% with 1 line in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/router/bot-identity-resolvers.ts	50.00%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!