## Summary
Add Linear DSS as a standalone Hub service for read-only progress across seven priority initiatives in the Builder Team workspace.
- Show initiative goals, reported health, linked project states, completion dates, target dates, and Linear source links in Initiative Progress. Scheduling stripes surface open projects without a target date.
- Follow up through People and project issues to distinguish open-project leads from assignees of in-progress issues. Issue reads cover non-private Linear teams and expose workflow states with cursor pagination.
- Support entitled WorkOS browser sessions, personal keys scoped to Linear DSS, and per-user WorkOS OAuth for the optional MCP connector. Enablement exposes the connector setup and the agent can read Enablement, BrainLift, and Dictionary through its tools.
- Label BrainLift as agent-generated guidance and describe its purpose without naming individual readers.
- Include Linear-owned infrastructure, release readiness, production context, and registration in the shared release workflow.
## Business Value
Readers can inspect priority initiative progress and ask an agent who is doing the work and how it contributes to the initiative goal. Answers can cite the underlying Linear records and identify gaps in health, scheduling, and outcome evidence. Approved users can connect through WorkOS sign-in without copying an API key into an agent chat.
## Implementation Effort
Estimated 3–4 engineering days for an average engineer working without AI assistance, using the existing DSS recipe. This includes the Linear adapter, initiative and People views, access controls, OAuth connector, infrastructure integration, and live validation.
## Verification
- TypeScript, Knip, file-scoped Biome checks, server and UI production builds, and Code Decorum passed locally. Infrastructure synthesis verified that enabling the connector adds only the Linear container's issuer setting.
- Isolated protocol checks covered all four MCP tools, wrong issuer audience, wrong organization, missing scope, expired tokens, and live entitlement revocation. Existing REST authentication and connector-disabled behavior were checked.
- On 11 Nov 2026 IST, deployed the exact candidate revision 55c3afc905f73afd77bb6dfc5b24c04b2fbb4b31 directly to the Linear runtime before merge. CloudFormation reached UPDATE_COMPLETE, the ECS task and load-balancer target were healthy, and the running digest was verified as sha256:7999be2c4249689c543810593ab6d7fc9a5553e5d4f5ff8602543f3732793577.
- Hosted checks returned seven initiatives, three people and 15 in-progress assignments for Automations, and paginated issue evidence with workflow states. Anonymous and invalid-key requests were denied. Hosted BrainLift, Enablement, and Dictionary matched the candidate files.
- A fresh ephemeral Codex run using the desktop-bundled CLI completed real WorkOS CIMD sign-in and all four hosted MCP tools. It read Enablement and BrainLift, cited Linear, separated project leads from issue assignees, and identified missing health, target dates, and measured outcomes.
- Production entitlement checks passed for the three pilot readers and six named team accounts after their additive Linear role assignments.
- Source-owner approval covers BrainLift and the project-lead, issue-assignee, and workflow-state data scope for entitled readers.
- Claude's end-to-end agent test remains pending because the local Claude account login needs refreshing.
## Release follow-up
The deployed candidate is included in this PR. The normal release workflow reads the protected linear-production environment's DSS_CONTEXT variable. Before the next workflow-driven release, add mcpIssuer: https://valid-mask-44.authkit.app to that context, matching services/linear/infra/production.json. The runtime currently has this setting from the approved direct deployment.
GitHub review is required for the updated head. The normal production promotion is a separate release step, with service selection checked against the approved rollout scope.
## Linear
- [AI-1277 — Automations live-data proof](https://linear.app/builder-team/issue/AI-1277/validate-live-linear-data-for-the-automations-initiative)
- [AI-1278 — Shared WorkOS entitlement prerequisite](https://linear.app/builder-team/issue/AI-1278/enforce-live-workos-service-entitlements-in-the-shared-dss-template)
- [Linear DSS project P-AI-288](https://linear.app/builder-team/project/linear-dss-b1f9302a0287)