@contractspec/example.project-management-sync 1.57.0 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,34 +1,35 @@
-$ 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.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=6
+Bundled 6 modules in 39ms
 
-✔ Build complete in 83773ms
+  docs/index.js                             1.60 KB  (entry point)
+  ./index.js                                6.84 KB  (entry point)
+  docs/project-management-sync.docblock.js  1.60 KB  (entry point)
+  ./example.js                              1.0 KB   (entry point)
+  ./run.js                                  4.26 KB  (entry point)
+  ./sync.js                                 4.24 KB  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=6
+Bundled 6 modules in 22ms
+
+  docs/index.js                             1.59 KB  (entry point)
+  ./index.js                                6.84 KB  (entry point)
+  docs/project-management-sync.docblock.js  1.59 KB  (entry point)
+  ./example.js                              1.0 KB   (entry point)
+  ./run.js                                  4.25 KB  (entry point)
+  ./sync.js                                 4.23 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=6
+Bundled 6 modules in 19ms
+
+  docs/index.js                             1.59 KB  (entry point)
+  ./index.js                                6.84 KB  (entry point)
+  docs/project-management-sync.docblock.js  1.59 KB  (entry point)
+  ./example.js                              1.0 KB   (entry point)
+  ./run.js                                  4.25 KB  (entry point)
+  ./sync.js                                 4.23 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @contractspec/example.project-management-sync
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/integration.providers-impls@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/browser/docs/index.js

@@ -0,0 +1,40 @@
+// src/docs/project-management-sync.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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/dist/browser/docs/project-management-sync.docblock.js

@@ -0,0 +1,40 @@
+// src/docs/project-management-sync.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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/dist/browser/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/index.js

@@ -0,0 +1,194 @@
+// src/docs/project-management-sync.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+
+// src/sync.ts
+import {
+  JiraProjectManagementProvider,
+  LinearProjectManagementProvider,
+  NotionProjectManagementProvider
+} from "@contractspec/integration.providers-impls/impls";
+async function syncProjectManagementWorkItems(input) {
+  const items = input.items ?? buildSampleWorkItems();
+  const summary = input.summary;
+  const dryRun = input.dryRun ?? false;
+  if (dryRun) {
+    return { summary, items };
+  }
+  const provider = input.providerClient ?? createProviderFromEnv(input.provider);
+  const createdSummary = summary ? await provider.createWorkItem(summary) : undefined;
+  const createdItems = await provider.createWorkItems(items);
+  return { summary: createdSummary, items: createdItems };
+}
+async function runProjectManagementSyncFromEnv() {
+  const provider = resolveProviderName();
+  const dryRun = process.env.CONTRACTSPEC_PM_DRY_RUN === "true";
+  const summary = provider === "notion" ? buildSampleSummary() : undefined;
+  return syncProjectManagementWorkItems({
+    provider,
+    summary,
+    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: 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;
+  const items = value.split(",").map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : undefined;
+}
+export {
+  syncProjectManagementWorkItems,
+  runProjectManagementSyncFromEnv,
+  resolveProviderName,
+  example_default as example,
+  createProviderFromEnv,
+  buildSampleWorkItems,
+  buildSampleSummary
+};

package/dist/browser/run.js

@@ -0,0 +1,122 @@
+// src/sync.ts
+import {
+  JiraProjectManagementProvider,
+  LinearProjectManagementProvider,
+  NotionProjectManagementProvider
+} from "@contractspec/integration.providers-impls/impls";
+async function syncProjectManagementWorkItems(input) {
+  const items = input.items ?? buildSampleWorkItems();
+  const summary = input.summary;
+  const dryRun = input.dryRun ?? false;
+  if (dryRun) {
+    return { summary, items };
+  }
+  const provider = input.providerClient ?? createProviderFromEnv(input.provider);
+  const createdSummary = summary ? await provider.createWorkItem(summary) : undefined;
+  const createdItems = await provider.createWorkItems(items);
+  return { summary: createdSummary, items: createdItems };
+}
+async function runProjectManagementSyncFromEnv() {
+  const provider = resolveProviderName();
+  const dryRun = process.env.CONTRACTSPEC_PM_DRY_RUN === "true";
+  const summary = provider === "notion" ? buildSampleSummary() : undefined;
+  return syncProjectManagementWorkItems({
+    provider,
+    summary,
+    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: 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;
+  const items = value.split(",").map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : undefined;
+}
+
+// src/run.ts
+runProjectManagementSyncFromEnv().then((result) => {
+  console.log(JSON.stringify(result, null, 2));
+}).catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

package/dist/browser/sync.js

@@ -0,0 +1,122 @@
+// src/sync.ts
+import {
+  JiraProjectManagementProvider,
+  LinearProjectManagementProvider,
+  NotionProjectManagementProvider
+} from "@contractspec/integration.providers-impls/impls";
+async function syncProjectManagementWorkItems(input) {
+  const items = input.items ?? buildSampleWorkItems();
+  const summary = input.summary;
+  const dryRun = input.dryRun ?? false;
+  if (dryRun) {
+    return { summary, items };
+  }
+  const provider = input.providerClient ?? createProviderFromEnv(input.provider);
+  const createdSummary = summary ? await provider.createWorkItem(summary) : undefined;
+  const createdItems = await provider.createWorkItems(items);
+  return { summary: createdSummary, items: createdItems };
+}
+async function runProjectManagementSyncFromEnv() {
+  const provider = resolveProviderName();
+  const dryRun = process.env.CONTRACTSPEC_PM_DRY_RUN === "true";
+  const summary = provider === "notion" ? buildSampleSummary() : undefined;
+  return syncProjectManagementWorkItems({
+    provider,
+    summary,
+    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: 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;
+  const items = value.split(",").map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : undefined;
+}
+export {
+  syncProjectManagementWorkItems,
+  runProjectManagementSyncFromEnv,
+  resolveProviderName,
+  createProviderFromEnv,
+  buildSampleWorkItems,
+  buildSampleSummary
+};

package/dist/docs/index.d.ts

@@ -1 +1,2 @@
-export { };
+import './project-management-sync.docblock';
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,oCAAoC,CAAC"}