@contractspec/example.project-management-sync 0.0.0-canary-20260206014742

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,33 @@
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/project-management-sync/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/run.ts, src/sync.ts, src/docs/index.ts, src/docs/project-management-sync.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 19 files
+ℹ dist/sync.js                                       3.95 kB │ gzip: 1.53 kB
+ℹ dist/docs/project-management-sync.docblock.js      1.60 kB │ gzip: 0.77 kB
+ℹ dist/example.js                                    1.04 kB │ gzip: 0.52 kB
+ℹ dist/index.js                                      0.41 kB │ gzip: 0.18 kB
+ℹ dist/run.js                                        0.30 kB │ gzip: 0.22 kB
+ℹ dist/docs/index.js                                 0.05 kB │ gzip: 0.07 kB
+ℹ dist/sync.js.map                                   7.29 kB │ gzip: 2.43 kB
+ℹ dist/docs/project-management-sync.docblock.js.map  2.12 kB │ gzip: 0.97 kB
+ℹ dist/example.js.map                                1.51 kB │ gzip: 0.72 kB
+ℹ dist/sync.d.ts.map                                 0.57 kB │ gzip: 0.28 kB
+ℹ dist/run.js.map                                    0.50 kB │ gzip: 0.34 kB
+ℹ dist/example.d.ts.map                              0.13 kB │ gzip: 0.13 kB
+ℹ dist/sync.d.ts                                     1.52 kB │ gzip: 0.44 kB
+ℹ dist/index.d.ts                                    0.56 kB │ gzip: 0.19 kB
+ℹ dist/example.d.ts                                  0.25 kB │ gzip: 0.17 kB
+ℹ dist/docs/index.d.ts                               0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/project-management-sync.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ dist/run.d.ts                                      0.01 kB │ gzip: 0.03 kB
+ℹ 18 files, total: 21.83 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - rolldown-plugin-dts:generate (50%)
+  - tsdown:external (50%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 29792ms

package/.turbo/turbo-build.log

@@ -0,0 +1,34 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/project-management-sync/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/run.ts, src/sync.ts, src/docs/index.ts, src/docs/project-management-sync.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/sync.js                                       3.95 kB │ gzip: 1.53 kB
+ℹ dist/docs/project-management-sync.docblock.js      1.60 kB │ gzip: 0.77 kB
+ℹ dist/example.js                                    1.04 kB │ gzip: 0.52 kB
+ℹ dist/index.js                                      0.41 kB │ gzip: 0.18 kB
+ℹ dist/run.js                                        0.30 kB │ gzip: 0.22 kB
+ℹ dist/docs/index.js                                 0.05 kB │ gzip: 0.07 kB
+ℹ dist/sync.js.map                                   7.29 kB │ gzip: 2.43 kB
+ℹ dist/docs/project-management-sync.docblock.js.map  2.12 kB │ gzip: 0.97 kB
+ℹ dist/example.js.map                                1.51 kB │ gzip: 0.72 kB
+ℹ dist/sync.d.ts.map                                 0.57 kB │ gzip: 0.28 kB
+ℹ dist/run.js.map                                    0.50 kB │ gzip: 0.34 kB
+ℹ dist/example.d.ts.map                              0.13 kB │ gzip: 0.13 kB
+ℹ dist/sync.d.ts                                     1.52 kB │ gzip: 0.44 kB
+ℹ dist/index.d.ts                                    0.56 kB │ gzip: 0.19 kB
+ℹ dist/example.d.ts                                  0.25 kB │ gzip: 0.17 kB
+ℹ dist/docs/index.d.ts                               0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/project-management-sync.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ dist/run.d.ts                                      0.01 kB │ gzip: 0.03 kB
+ℹ 18 files, total: 21.83 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - rolldown-plugin-dts:generate (50%)
+  - tsdown:external (50%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 21571ms

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @contractspec/example.project-management-sync
+
+## 0.0.0-canary-20260206014742
+
+### Minor Changes
+
+- 7cb7e0a: Add a project management sync example using Linear, Jira, and Notion providers.
+
+### Patch Changes
+
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@0.0.0-canary-20260206014742
+  - @contractspec/integration.providers-impls@0.0.0-canary-20260206014742
+
+## 1.56.1
+
+### Minor Changes
+
+- Initial project management sync example.
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/integration.providers-impls@1.56.1
+  - @contractspec/lib.contracts@1.56.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+### Integration Example - Project Management Sync
+
+Website: https://contractspec.io/
+
+This example shows how to create work items in Linear, Jira Cloud, and Notion using the project-management providers.
+
+Files included:
+
+- `example.ts` – example metadata for the catalog.
+- `sync.ts` – helper to build sample work items and sync them to a provider.
+- `docs/project-management-sync.docblock.ts` – documentation blocks for MCP/docs.
+
+Usage:
+
+```bash
+export CONTRACTSPEC_PM_PROVIDER="linear" # linear | jira | notion
+export CONTRACTSPEC_PM_DRY_RUN="true"    # set to false to create real items
+
+# Linear
+export LINEAR_API_KEY="your_key"
+export LINEAR_TEAM_ID="team_id"
+
+# Jira Cloud
+# export JIRA_SITE_URL="https://acme.atlassian.net"
+# export JIRA_EMAIL="user@acme.com"
+# export JIRA_API_TOKEN="jira_token"
+# export JIRA_PROJECT_KEY="PM"
+
+# Notion
+# export NOTION_API_KEY="secret"
+# export NOTION_DATABASE_ID="database_id"
+# export NOTION_SUMMARY_PARENT_PAGE_ID="parent_page_id" # optional
+
+bun tsx packages/examples/project-management-sync/src/run.ts
+```

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./project-management-sync.docblock.js";

package/dist/docs/project-management-sync.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/project-management-sync.docblock.js

@@ -0,0 +1,46 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/project-management-sync.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.project-management-sync",
+	title: "Project Management Sync (example)",
+	summary: "Create a shared payload of work items and sync it to Linear, Jira Cloud, or Notion.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/project-management-sync",
+	tags: [
+		"project-management",
+		"linear",
+		"jira",
+		"notion",
+		"example"
+	],
+	body: `## What this example shows
+- Build a provider-agnostic payload of work items.
+- Resolve the target provider from environment variables.
+- Run in dry-run mode for preview output.
+
+## Guardrails
+- Keep secrets in env or secret providers only.
+- Use dry-run to validate payloads before writing.
+- Start with a small batch of tasks to validate setup.`
+}, {
+	id: "docs.examples.project-management-sync.usage",
+	title: "Project Management Sync - Usage",
+	summary: "How to run the sync with env-driven provider settings.",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/examples/project-management-sync/usage",
+	tags: ["project-management", "usage"],
+	body: `## Usage
+- Set CONTRACTSPEC_PM_PROVIDER to linear, jira, or notion.
+- Set CONTRACTSPEC_PM_DRY_RUN=true to preview payloads.
+- Provide provider-specific env vars (API keys, project IDs).
+
+## Example
+- Call runProjectManagementSyncFromEnv() from sync.ts or import it in your app.
+- The helper builds a sample payload and calls the provider client.`
+}]);
+
+//#endregion
+//# sourceMappingURL=project-management-sync.docblock.js.map

package/dist/docs/project-management-sync.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-management-sync.docblock.js","names":[],"sources":["../../src/docs/project-management-sync.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n  {\n    id: 'docs.examples.project-management-sync',\n    title: 'Project Management Sync (example)',\n    summary:\n      'Create a shared payload of work items and sync it to Linear, Jira Cloud, or Notion.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/project-management-sync',\n    tags: ['project-management', 'linear', 'jira', 'notion', 'example'],\n    body: `## What this example shows\n- Build a provider-agnostic payload of work items.\n- Resolve the target provider from environment variables.\n- Run in dry-run mode for preview output.\n\n## Guardrails\n- Keep secrets in env or secret providers only.\n- Use dry-run to validate payloads before writing.\n- Start with a small batch of tasks to validate setup.`,\n  },\n  {\n    id: 'docs.examples.project-management-sync.usage',\n    title: 'Project Management Sync - Usage',\n    summary: 'How to run the sync with env-driven provider settings.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/project-management-sync/usage',\n    tags: ['project-management', 'usage'],\n    body: `## Usage\n- Set CONTRACTSPEC_PM_PROVIDER to linear, jira, or notion.\n- Set CONTRACTSPEC_PM_DRY_RUN=true to preview payloads.\n- Provide provider-specific env vars (API keys, project IDs).\n\n## Example\n- Call runProjectManagementSyncFromEnv() from sync.ts or import it in your app.\n- The helper builds a sample payload and calls the provider client.`,\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AA0CA,kBAvC2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAsB;EAAU;EAAQ;EAAU;EAAU;CACnE,MAAM;;;;;;;;;CASP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,sBAAsB,QAAQ;CACrC,MAAM;;;;;;;;CAQP,CACF,CAEwB"}

package/dist/example.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/example.d.ts
+declare const example: _contractspec_lib_contracts0.ExampleSpec;
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"mappings":";;;cAEM,OAAA,EA2BJ,4BAAA,CA3BW,WAAA"}

package/dist/example.js

@@ -0,0 +1,46 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
+//#region src/example.ts
+const example = defineExample({
+	meta: {
+		key: "project-management-sync",
+		version: "1.0.0",
+		title: "Project Management Sync",
+		description: "Create project-management work items in Linear, Jira Cloud, or Notion from a shared payload.",
+		kind: "integration",
+		visibility: "public",
+		stability: "experimental",
+		owners: ["@platform.integrations"],
+		tags: [
+			"project-management",
+			"linear",
+			"jira",
+			"notion",
+			"integrations"
+		]
+	},
+	docs: {
+		rootDocId: "docs.examples.project-management-sync",
+		usageDocId: "docs.examples.project-management-sync.usage"
+	},
+	entrypoints: {
+		packageName: "@contractspec/example.project-management-sync",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["markdown", "specs"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+});
+
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'project-management-sync',\n    version: '1.0.0',\n    title: 'Project Management Sync',\n    description:\n      'Create project-management work items in Linear, Jira Cloud, or Notion from a shared payload.',\n    kind: 'integration',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.integrations'],\n    tags: ['project-management', 'linear', 'jira', 'notion', 'integrations'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.project-management-sync',\n    usageDocId: 'docs.examples.project-management-sync.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.project-management-sync',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,yBAAyB;EAClC,MAAM;GAAC;GAAsB;GAAU;GAAQ;GAAU;GAAe;EACzE;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import example from "./example.js";
+import { ProjectManagementProviderName, ProjectManagementSyncInput, ProjectManagementSyncOutput, buildSampleSummary, buildSampleWorkItems, createProviderFromEnv, resolveProviderName, runProjectManagementSyncFromEnv, syncProjectManagementWorkItems } from "./sync.js";
+export { ProjectManagementProviderName, ProjectManagementSyncInput, ProjectManagementSyncOutput, buildSampleSummary, buildSampleWorkItems, createProviderFromEnv, example, resolveProviderName, runProjectManagementSyncFromEnv, syncProjectManagementWorkItems };

package/dist/index.js

@@ -0,0 +1,5 @@
+import example from "./example.js";
+import { buildSampleSummary, buildSampleWorkItems, createProviderFromEnv, resolveProviderName, runProjectManagementSyncFromEnv, syncProjectManagementWorkItems } from "./sync.js";
+import "./docs/index.js";
+
+export { buildSampleSummary, buildSampleWorkItems, createProviderFromEnv, example, resolveProviderName, runProjectManagementSyncFromEnv, syncProjectManagementWorkItems };

package/dist/run.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/run.js

@@ -0,0 +1,12 @@
+import { runProjectManagementSyncFromEnv } from "./sync.js";
+
+//#region src/run.ts
+runProjectManagementSyncFromEnv().then((result) => {
+	console.log(JSON.stringify(result, null, 2));
+}).catch((error) => {
+	console.error(error);
+	process.exitCode = 1;
+});
+
+//#endregion
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","names":[],"sources":["../src/run.ts"],"sourcesContent":["import { runProjectManagementSyncFromEnv } from './sync';\n\nrunProjectManagementSyncFromEnv()\n  .then((result) => {\n    console.log(JSON.stringify(result, null, 2));\n  })\n  .catch((error) => {\n    console.error(error);\n    process.exitCode = 1;\n  });\n"],"mappings":";;;AAEA,iCAAiC,CAC9B,MAAM,WAAW;AAChB,SAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC;EAC5C,CACD,OAAO,UAAU;AAChB,SAAQ,MAAM,MAAM;AACpB,SAAQ,WAAW;EACnB"}

package/dist/sync.d.ts

@@ -0,0 +1,24 @@
+import { ProjectManagementProvider, ProjectManagementWorkItem, ProjectManagementWorkItemInput } from "@contractspec/integration.providers-impls/project-management";
+
+//#region src/sync.d.ts
+type ProjectManagementProviderName = 'linear' | 'jira' | 'notion';
+interface ProjectManagementSyncInput {
+  provider: ProjectManagementProviderName;
+  providerClient?: ProjectManagementProvider;
+  items?: ProjectManagementWorkItemInput[];
+  summary?: ProjectManagementWorkItemInput;
+  dryRun?: boolean;
+}
+interface ProjectManagementSyncOutput {
+  summary?: ProjectManagementWorkItem | ProjectManagementWorkItemInput;
+  items: ProjectManagementWorkItem[] | ProjectManagementWorkItemInput[];
+}
+declare function syncProjectManagementWorkItems(input: ProjectManagementSyncInput): Promise<ProjectManagementSyncOutput>;
+declare function runProjectManagementSyncFromEnv(): Promise<ProjectManagementSyncOutput>;
+declare function buildSampleWorkItems(): ProjectManagementWorkItemInput[];
+declare function buildSampleSummary(): ProjectManagementWorkItemInput;
+declare function createProviderFromEnv(provider: ProjectManagementProviderName): ProjectManagementProvider;
+declare function resolveProviderName(): ProjectManagementProviderName;
+//#endregion
+export { ProjectManagementProviderName, ProjectManagementSyncInput, ProjectManagementSyncOutput, buildSampleSummary, buildSampleWorkItems, createProviderFromEnv, resolveProviderName, runProjectManagementSyncFromEnv, syncProjectManagementWorkItems };
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","names":[],"sources":["../src/sync.ts"],"mappings":";;;KAWY,6BAAA;AAAA,UAEK,0BAAA;EACf,QAAA,EAAU,6BAAA;EACV,cAAA,GAAiB,yBAAA;EACjB,KAAA,GAAQ,8BAAA;EACR,OAAA,GAAU,8BAAA;EACV,MAAA;AAAA;AAAA,UAGe,2BAAA;EACf,OAAA,GAAU,yBAAA,GAA4B,8BAAA;EACtC,KAAA,EAAO,yBAAA,KAA8B,8BAAA;AAAA;AAAA,iBAGjB,8BAAA,CACpB,KAAA,EAAO,0BAAA,GACN,OAAA,CAAQ,2BAAA;AAAA,iBAkBW,+BAAA,CAAA,GAAmC,OAAA,CAAQ,2BAAA;AAAA,iBAWjD,oBAAA,CAAA,GAAwB,8BAAA;AAAA,iBA8BxB,kBAAA,CAAA,GAAsB,8BAAA;AAAA,iBAUtB,qBAAA,CACd,QAAA,EAAU,6BAAA,GACT,yBAAA;AAAA,iBAoCa,mBAAA,CAAA,GAAuB,6BAAA"}

package/dist/sync.js

@@ -0,0 +1,107 @@
+import { JiraProjectManagementProvider, LinearProjectManagementProvider, NotionProjectManagementProvider } from "@contractspec/integration.providers-impls/impls";
+
+//#region src/sync.ts
+async function syncProjectManagementWorkItems(input) {
+	const items = input.items ?? buildSampleWorkItems();
+	const summary = input.summary;
+	if (input.dryRun ?? false) return {
+		summary,
+		items
+	};
+	const provider = input.providerClient ?? createProviderFromEnv(input.provider);
+	return {
+		summary: summary ? await provider.createWorkItem(summary) : void 0,
+		items: await provider.createWorkItems(items)
+	};
+}
+async function runProjectManagementSyncFromEnv() {
+	const provider = resolveProviderName();
+	const dryRun = process.env.CONTRACTSPEC_PM_DRY_RUN === "true";
+	return syncProjectManagementWorkItems({
+		provider,
+		summary: provider === "notion" ? buildSampleSummary() : void 0,
+		dryRun
+	});
+}
+function buildSampleWorkItems() {
+	return [
+		{
+			title: "Review onboarding drop-off",
+			description: "Analyze activation funnel to identify the highest drop-off step and propose fixes.",
+			type: "task",
+			priority: "high",
+			tags: ["onboarding", "insights"]
+		},
+		{
+			title: "Ship first-run checklist",
+			description: "Create a guided checklist with 3-5 steps to help new users reach first value.",
+			type: "task",
+			priority: "medium",
+			tags: ["activation", "ux"],
+			dueDate: /* @__PURE__ */ new Date("2026-02-15")
+		},
+		{
+			title: "Define success metrics",
+			description: "Agree on activation success metrics and instrument key events.",
+			type: "task",
+			priority: "low",
+			tags: ["analytics", "tracking"]
+		}
+	];
+}
+function buildSampleSummary() {
+	return {
+		title: "Product Intent Summary",
+		description: "This summary aggregates the onboarding tasks and highlights the activation improvements to prioritize.",
+		type: "summary",
+		tags: ["product-intent", "summary"]
+	};
+}
+function createProviderFromEnv(provider) {
+	if (provider === "linear") return new LinearProjectManagementProvider({
+		apiKey: requireEnv("LINEAR_API_KEY"),
+		teamId: requireEnv("LINEAR_TEAM_ID"),
+		projectId: process.env.LINEAR_PROJECT_ID,
+		stateId: process.env.LINEAR_STATE_ID,
+		assigneeId: process.env.LINEAR_ASSIGNEE_ID,
+		labelIds: splitList(process.env.LINEAR_LABEL_IDS)
+	});
+	if (provider === "jira") return new JiraProjectManagementProvider({
+		siteUrl: requireEnv("JIRA_SITE_URL"),
+		email: requireEnv("JIRA_EMAIL"),
+		apiToken: requireEnv("JIRA_API_TOKEN"),
+		projectKey: process.env.JIRA_PROJECT_KEY,
+		issueType: process.env.JIRA_ISSUE_TYPE,
+		defaultLabels: splitList(process.env.JIRA_DEFAULT_LABELS)
+	});
+	return new NotionProjectManagementProvider({
+		apiKey: requireEnv("NOTION_API_KEY"),
+		databaseId: process.env.NOTION_DATABASE_ID,
+		summaryParentPageId: process.env.NOTION_SUMMARY_PARENT_PAGE_ID,
+		titleProperty: process.env.NOTION_TITLE_PROPERTY,
+		statusProperty: process.env.NOTION_STATUS_PROPERTY,
+		priorityProperty: process.env.NOTION_PRIORITY_PROPERTY,
+		tagsProperty: process.env.NOTION_TAGS_PROPERTY,
+		dueDateProperty: process.env.NOTION_DUE_DATE_PROPERTY,
+		descriptionProperty: process.env.NOTION_DESCRIPTION_PROPERTY
+	});
+}
+function resolveProviderName() {
+	const raw = (process.env.CONTRACTSPEC_PM_PROVIDER ?? "linear").toLowerCase();
+	if (raw === "linear" || raw === "jira" || raw === "notion") return raw;
+	throw new Error(`Unsupported provider: ${raw}. Use one of: linear, jira, notion`);
+}
+function requireEnv(key) {
+	const value = process.env[key];
+	if (!value) throw new Error(`Missing required env var: ${key}`);
+	return value;
+}
+function splitList(value) {
+	if (!value) return void 0;
+	const items = value.split(",").map((item) => item.trim()).filter(Boolean);
+	return items.length > 0 ? items : void 0;
+}
+
+//#endregion
+export { buildSampleSummary, buildSampleWorkItems, createProviderFromEnv, resolveProviderName, runProjectManagementSyncFromEnv, syncProjectManagementWorkItems };
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","names":[],"sources":["../src/sync.ts"],"sourcesContent":["import {\n  JiraProjectManagementProvider,\n  LinearProjectManagementProvider,\n  NotionProjectManagementProvider,\n} from '@contractspec/integration.providers-impls/impls';\nimport type {\n  ProjectManagementProvider,\n  ProjectManagementWorkItem,\n  ProjectManagementWorkItemInput,\n} from '@contractspec/integration.providers-impls/project-management';\n\nexport type ProjectManagementProviderName = 'linear' | 'jira' | 'notion';\n\nexport interface ProjectManagementSyncInput {\n  provider: ProjectManagementProviderName;\n  providerClient?: ProjectManagementProvider;\n  items?: ProjectManagementWorkItemInput[];\n  summary?: ProjectManagementWorkItemInput;\n  dryRun?: boolean;\n}\n\nexport interface ProjectManagementSyncOutput {\n  summary?: ProjectManagementWorkItem | ProjectManagementWorkItemInput;\n  items: ProjectManagementWorkItem[] | ProjectManagementWorkItemInput[];\n}\n\nexport async function syncProjectManagementWorkItems(\n  input: ProjectManagementSyncInput\n): Promise<ProjectManagementSyncOutput> {\n  const items = input.items ?? buildSampleWorkItems();\n  const summary = input.summary;\n  const dryRun = input.dryRun ?? false;\n\n  if (dryRun) {\n    return { summary, items };\n  }\n\n  const provider =\n    input.providerClient ?? createProviderFromEnv(input.provider);\n  const createdSummary = summary\n    ? await provider.createWorkItem(summary)\n    : undefined;\n  const createdItems = await provider.createWorkItems(items);\n  return { summary: createdSummary, items: createdItems };\n}\n\nexport async function runProjectManagementSyncFromEnv(): Promise<ProjectManagementSyncOutput> {\n  const provider = resolveProviderName();\n  const dryRun = process.env.CONTRACTSPEC_PM_DRY_RUN === 'true';\n  const summary = provider === 'notion' ? buildSampleSummary() : undefined;\n  return syncProjectManagementWorkItems({\n    provider,\n    summary,\n    dryRun,\n  });\n}\n\nexport function buildSampleWorkItems(): ProjectManagementWorkItemInput[] {\n  return [\n    {\n      title: 'Review onboarding drop-off',\n      description:\n        'Analyze activation funnel to identify the highest drop-off step and propose fixes.',\n      type: 'task',\n      priority: 'high',\n      tags: ['onboarding', 'insights'],\n    },\n    {\n      title: 'Ship first-run checklist',\n      description:\n        'Create a guided checklist with 3-5 steps to help new users reach first value.',\n      type: 'task',\n      priority: 'medium',\n      tags: ['activation', 'ux'],\n      dueDate: new Date('2026-02-15'),\n    },\n    {\n      title: 'Define success metrics',\n      description:\n        'Agree on activation success metrics and instrument key events.',\n      type: 'task',\n      priority: 'low',\n      tags: ['analytics', 'tracking'],\n    },\n  ];\n}\n\nexport function buildSampleSummary(): ProjectManagementWorkItemInput {\n  return {\n    title: 'Product Intent Summary',\n    description:\n      'This summary aggregates the onboarding tasks and highlights the activation improvements to prioritize.',\n    type: 'summary',\n    tags: ['product-intent', 'summary'],\n  };\n}\n\nexport function createProviderFromEnv(\n  provider: ProjectManagementProviderName\n): ProjectManagementProvider {\n  if (provider === 'linear') {\n    return new LinearProjectManagementProvider({\n      apiKey: requireEnv('LINEAR_API_KEY'),\n      teamId: requireEnv('LINEAR_TEAM_ID'),\n      projectId: process.env.LINEAR_PROJECT_ID,\n      stateId: process.env.LINEAR_STATE_ID,\n      assigneeId: process.env.LINEAR_ASSIGNEE_ID,\n      labelIds: splitList(process.env.LINEAR_LABEL_IDS),\n    });\n  }\n\n  if (provider === 'jira') {\n    return new JiraProjectManagementProvider({\n      siteUrl: requireEnv('JIRA_SITE_URL'),\n      email: requireEnv('JIRA_EMAIL'),\n      apiToken: requireEnv('JIRA_API_TOKEN'),\n      projectKey: process.env.JIRA_PROJECT_KEY,\n      issueType: process.env.JIRA_ISSUE_TYPE,\n      defaultLabels: splitList(process.env.JIRA_DEFAULT_LABELS),\n    });\n  }\n\n  return new NotionProjectManagementProvider({\n    apiKey: requireEnv('NOTION_API_KEY'),\n    databaseId: process.env.NOTION_DATABASE_ID,\n    summaryParentPageId: process.env.NOTION_SUMMARY_PARENT_PAGE_ID,\n    titleProperty: process.env.NOTION_TITLE_PROPERTY,\n    statusProperty: process.env.NOTION_STATUS_PROPERTY,\n    priorityProperty: process.env.NOTION_PRIORITY_PROPERTY,\n    tagsProperty: process.env.NOTION_TAGS_PROPERTY,\n    dueDateProperty: process.env.NOTION_DUE_DATE_PROPERTY,\n    descriptionProperty: process.env.NOTION_DESCRIPTION_PROPERTY,\n  });\n}\n\nexport function resolveProviderName(): ProjectManagementProviderName {\n  const raw = (process.env.CONTRACTSPEC_PM_PROVIDER ?? 'linear').toLowerCase();\n  if (raw === 'linear' || raw === 'jira' || raw === 'notion') return raw;\n  throw new Error(\n    `Unsupported provider: ${raw}. Use one of: linear, jira, notion`\n  );\n}\n\nfunction requireEnv(key: string): string {\n  const value = process.env[key];\n  if (!value) {\n    throw new Error(`Missing required env var: ${key}`);\n  }\n  return value;\n}\n\nfunction splitList(value?: string): string[] | undefined {\n  if (!value) return undefined;\n  const items = value\n    .split(',')\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n"],"mappings":";;;AA0BA,eAAsB,+BACpB,OACsC;CACtC,MAAM,QAAQ,MAAM,SAAS,sBAAsB;CACnD,MAAM,UAAU,MAAM;AAGtB,KAFe,MAAM,UAAU,MAG7B,QAAO;EAAE;EAAS;EAAO;CAG3B,MAAM,WACJ,MAAM,kBAAkB,sBAAsB,MAAM,SAAS;AAK/D,QAAO;EAAE,SAJc,UACnB,MAAM,SAAS,eAAe,QAAQ,GACtC;EAE8B,OADb,MAAM,SAAS,gBAAgB,MAAM;EACH;;AAGzD,eAAsB,kCAAwE;CAC5F,MAAM,WAAW,qBAAqB;CACtC,MAAM,SAAS,QAAQ,IAAI,4BAA4B;AAEvD,QAAO,+BAA+B;EACpC;EACA,SAHc,aAAa,WAAW,oBAAoB,GAAG;EAI7D;EACD,CAAC;;AAGJ,SAAgB,uBAAyD;AACvE,QAAO;EACL;GACE,OAAO;GACP,aACE;GACF,MAAM;GACN,UAAU;GACV,MAAM,CAAC,cAAc,WAAW;GACjC;EACD;GACE,OAAO;GACP,aACE;GACF,MAAM;GACN,UAAU;GACV,MAAM,CAAC,cAAc,KAAK;GAC1B,yBAAS,IAAI,KAAK,aAAa;GAChC;EACD;GACE,OAAO;GACP,aACE;GACF,MAAM;GACN,UAAU;GACV,MAAM,CAAC,aAAa,WAAW;GAChC;EACF;;AAGH,SAAgB,qBAAqD;AACnE,QAAO;EACL,OAAO;EACP,aACE;EACF,MAAM;EACN,MAAM,CAAC,kBAAkB,UAAU;EACpC;;AAGH,SAAgB,sBACd,UAC2B;AAC3B,KAAI,aAAa,SACf,QAAO,IAAI,gCAAgC;EACzC,QAAQ,WAAW,iBAAiB;EACpC,QAAQ,WAAW,iBAAiB;EACpC,WAAW,QAAQ,IAAI;EACvB,SAAS,QAAQ,IAAI;EACrB,YAAY,QAAQ,IAAI;EACxB,UAAU,UAAU,QAAQ,IAAI,iBAAiB;EAClD,CAAC;AAGJ,KAAI,aAAa,OACf,QAAO,IAAI,8BAA8B;EACvC,SAAS,WAAW,gBAAgB;EACpC,OAAO,WAAW,aAAa;EAC/B,UAAU,WAAW,iBAAiB;EACtC,YAAY,QAAQ,IAAI;EACxB,WAAW,QAAQ,IAAI;EACvB,eAAe,UAAU,QAAQ,IAAI,oBAAoB;EAC1D,CAAC;AAGJ,QAAO,IAAI,gCAAgC;EACzC,QAAQ,WAAW,iBAAiB;EACpC,YAAY,QAAQ,IAAI;EACxB,qBAAqB,QAAQ,IAAI;EACjC,eAAe,QAAQ,IAAI;EAC3B,gBAAgB,QAAQ,IAAI;EAC5B,kBAAkB,QAAQ,IAAI;EAC9B,cAAc,QAAQ,IAAI;EAC1B,iBAAiB,QAAQ,IAAI;EAC7B,qBAAqB,QAAQ,IAAI;EAClC,CAAC;;AAGJ,SAAgB,sBAAqD;CACnE,MAAM,OAAO,QAAQ,IAAI,4BAA4B,UAAU,aAAa;AAC5E,KAAI,QAAQ,YAAY,QAAQ,UAAU,QAAQ,SAAU,QAAO;AACnE,OAAM,IAAI,MACR,yBAAyB,IAAI,oCAC9B;;AAGH,SAAS,WAAW,KAAqB;CACvC,MAAM,QAAQ,QAAQ,IAAI;AAC1B,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,6BAA6B,MAAM;AAErD,QAAO;;AAGT,SAAS,UAAU,OAAsC;AACvD,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,QAAQ,MACX,MAAM,IAAI,CACV,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAAQ;AAClB,QAAO,MAAM,SAAS,IAAI,QAAQ"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@contractspec/example.project-management-sync",
+  "version": "0.0.0-canary-20260206014742",
+  "description": "Project management sync example: Linear, Jira, and Notion work item creation.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/project-management-sync.docblock": "./dist/docs/project-management-sync.docblock.js",
+    "./example": "./dist/example.js",
+    "./run": "./dist/run.js",
+    "./sync": "./dist/sync.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/integration.providers-impls": "0.0.0-canary-20260206014742",
+    "@contractspec/lib.contracts": "0.0.0-canary-20260206014742"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260206014742",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260206014742",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/project-management-sync.docblock": "./dist/docs/project-management-sync.docblock.js",
+      "./example": "./dist/example.js",
+      "./run": "./dist/run.js",
+      "./sync": "./dist/sync.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/project-management-sync"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './project-management-sync.docblock';

package/src/docs/project-management-sync.docblock.ts

@@ -0,0 +1,43 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const blocks: DocBlock[] = [
+  {
+    id: 'docs.examples.project-management-sync',
+    title: 'Project Management Sync (example)',
+    summary:
+      'Create a shared payload of work items and sync it to Linear, Jira Cloud, or Notion.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/examples/project-management-sync',
+    tags: ['project-management', 'linear', 'jira', 'notion', 'example'],
+    body: `## What this example shows
+- Build a provider-agnostic payload of work items.
+- Resolve the target provider from environment variables.
+- Run in dry-run mode for preview output.
+
+## Guardrails
+- Keep secrets in env or secret providers only.
+- Use dry-run to validate payloads before writing.
+- Start with a small batch of tasks to validate setup.`,
+  },
+  {
+    id: 'docs.examples.project-management-sync.usage',
+    title: 'Project Management Sync - Usage',
+    summary: 'How to run the sync with env-driven provider settings.',
+    kind: 'usage',
+    visibility: 'public',
+    route: '/docs/examples/project-management-sync/usage',
+    tags: ['project-management', 'usage'],
+    body: `## Usage
+- Set CONTRACTSPEC_PM_PROVIDER to linear, jira, or notion.
+- Set CONTRACTSPEC_PM_DRY_RUN=true to preview payloads.
+- Provide provider-specific env vars (API keys, project IDs).
+
+## Example
+- Call runProjectManagementSyncFromEnv() from sync.ts or import it in your app.
+- The helper builds a sample payload and calls the provider client.`,
+  },
+];
+
+registerDocBlocks(blocks);

package/src/example.ts

@@ -0,0 +1,32 @@
+import { defineExample } from '@contractspec/lib.contracts';
+
+const example = defineExample({
+  meta: {
+    key: 'project-management-sync',
+    version: '1.0.0',
+    title: 'Project Management Sync',
+    description:
+      'Create project-management work items in Linear, Jira Cloud, or Notion from a shared payload.',
+    kind: 'integration',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@platform.integrations'],
+    tags: ['project-management', 'linear', 'jira', 'notion', 'integrations'],
+  },
+  docs: {
+    rootDocId: 'docs.examples.project-management-sync',
+    usageDocId: 'docs.examples.project-management-sync.usage',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.project-management-sync',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['markdown', 'specs'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+});
+
+export default example;

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './sync';
+export { default as example } from './example';
+import './docs';

package/src/run.ts

@@ -0,0 +1,10 @@
+import { runProjectManagementSyncFromEnv } from './sync';
+
+runProjectManagementSyncFromEnv()
+  .then((result) => {
+    console.log(JSON.stringify(result, null, 2));
+  })
+  .catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+  });