integration.provider-project-management
Project management provider implementations for ContractSpec.
@lssm-tech/integration.provider-project-managementbun add @lssm-tech/integration.provider-project-managementManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Website: https://contractspec.io
Project management provider implementations for ContractSpec.
./coverage exports a machine-readable coverage-manifest builder. It reports implemented capabilities separately from provider/production qualification and does not invent sync-lag measurements or webhook verification.
./impls/asana is the direct Asana task connector. It uses injected bearer credentials, supports task CRUD/import, workspace event-stream deltas when a workspace is configured, and HMAC-verified webhook ingestion when a webhook secret is configured. Its capability manifest is dynamic: unavailable optional transport paths are not advertised.
./impls/clickup is the direct ClickUp task connector. It supports task CRUD, list import, and HMAC-verified webhooks. ClickUp does not expose a comparable delta cursor in this adapter, so it is deliberately not advertised as one.
./impls/taskade is the direct Taskade task connector. It supports project task CRUD and cursor-based import through Taskade's public API. It intentionally advertises only import_once: a signed outbound-webhook verification contract has not been confirmed, so it cannot safely claim live mirroring or two-way sync.
./impls/motion is the direct Motion task connector. It supports documented task reads, cursor import, create, and deletion using an injected API key. It does not claim update/webhook/delta/two-way support; OPA remains canonical for CompanyOS schedule plans rather than importing Motion placement as native state.
Usage
Import the root entrypoint for the domain surface, or import a concrete implementation from the ./impls/* subpaths.
Compatibility
This package owns the project-management implementation slice split out of @lssm-tech/integration.providers-impls. The legacy package continues to re-export these subpaths for existing consumers.
Delegated Linear reads
./impls/linear additionally exports createLinearConnectionReader and createLinearReadConnectionProvider. These use official OAuth bearer tokens, server-side GraphQL team/project filters, bounded cursor pages, and explicit resource grants. The broker factory implements the integration runtime connection port, PKCE, rotating refresh tokens, revocation, and account binding. Configure one team per issue-reading connection because the broker exposes no arbitrary resource selector. listTeams supports discovery across an explicitly granted team set.
These readers do not change the existing create-only Work Sync adapter or claim provider/production qualification. Read errors expose fixed codes only. Tokens remain transient server-side input and belong in the host's SecretProvider vault.
Protocol references: GraphQL, pagination, filters, and OAuth lifecycle.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
2 declarations
@lssm-tech/integration.runtimeworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-integrationsworkspace:^
Read the package manual ↗
Declared capabilities
Project management provider implementations for ContractSpec.
Scripts
buildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolint:checknode ../../../scripts/biome.cjs check .lint:fixnode ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .testbun testprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit