@contractspec/lib.product-intent-utils 3.7.6 → 3.7.10

package/dist/index.js

@@ -1,4 +1,205 @@
 // @bun
+// src/impact-engine.ts
+var SURFACE_MAP = {
+  add_field: ["api", "db", "ui", "docs", "tests"],
+  remove_field: ["api", "db", "ui", "docs", "tests"],
+  rename_field: ["api", "db", "ui", "docs", "tests"],
+  add_event: ["api", "workflows", "docs", "tests"],
+  update_event: ["api", "workflows", "docs", "tests"],
+  add_operation: ["api", "ui", "workflows", "docs", "tests"],
+  update_operation: ["api", "ui", "workflows", "docs", "tests"],
+  update_form: ["ui", "docs", "tests"],
+  update_policy: ["policy", "api", "workflows", "docs", "tests"],
+  add_enum_value: ["api", "db", "ui", "docs", "tests"],
+  remove_enum_value: ["api", "db", "ui", "docs", "tests"],
+  other: ["docs", "tests"]
+};
+var BUCKET_MAP = {
+  remove_field: "breaks",
+  rename_field: "breaks",
+  remove_enum_value: "breaks",
+  update_operation: "mustChange",
+  update_event: "mustChange",
+  update_policy: "mustChange",
+  update_form: "risky",
+  add_field: "risky",
+  add_event: "risky",
+  add_operation: "risky",
+  add_enum_value: "risky",
+  other: "risky"
+};
+function slugify(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)+/g, "");
+}
+function buildTokens(change) {
+  const combined = `${change.type} ${change.target} ${change.detail}`;
+  const tokens = combined.split(/[^a-zA-Z0-9]+/).map((token) => token.trim()).filter((token) => token.length >= 3);
+  return Array.from(new Set(tokens.map((token) => token.toLowerCase()))).slice(0, 8);
+}
+function scanTokens(tokens, files, maxHits) {
+  const hits = [];
+  const lowerTokens = tokens.map((token) => token.toLowerCase());
+  for (const file of files) {
+    const haystack = file.content.toLowerCase();
+    if (lowerTokens.some((token) => haystack.includes(token))) {
+      hits.push(file.path);
+    }
+    if (hits.length >= maxHits)
+      break;
+  }
+  return hits;
+}
+function formatRefs(tokens, repoFiles, maxHits = 3) {
+  if (!repoFiles || repoFiles.length === 0) {
+    return "refs: (no repo scan)";
+  }
+  const hits = scanTokens(tokens, repoFiles, maxHits);
+  if (!hits.length)
+    return "refs: none";
+  return `refs: ${hits.join(", ")}`;
+}
+function humanizeChange(change) {
+  const label = change.type.replace(/_/g, " ");
+  return `${label} ${change.target}`;
+}
+function buildStatement(change, refs, surfaces) {
+  const reason = change.detail || `touches ${surfaces.join(", ")}`;
+  return `${humanizeChange(change)} because ${reason} (${refs})`;
+}
+function impactEngine(intent, options = {}) {
+  const reportId = options.reportId ?? `impact-${slugify(intent.featureKey)}`;
+  const patchId = options.patchId ?? `patch-${slugify(intent.featureKey)}`;
+  const maxHitsPerChange = options.maxHitsPerChange ?? 3;
+  const breaks = [];
+  const mustChange = [];
+  const risky = [];
+  const surfaces = {
+    api: [],
+    db: [],
+    ui: [],
+    workflows: [],
+    policy: [],
+    docs: [],
+    tests: []
+  };
+  for (const change of intent.changes) {
+    const bucket = BUCKET_MAP[change.type] ?? "risky";
+    const surfaceTargets = SURFACE_MAP[change.type] ?? ["docs", "tests"];
+    const tokens = buildTokens(change);
+    const refs = formatRefs(tokens, options.repoFiles, maxHitsPerChange);
+    const statement = buildStatement(change, refs, surfaceTargets);
+    if (bucket === "breaks")
+      breaks.push(statement);
+    if (bucket === "mustChange")
+      mustChange.push(statement);
+    if (bucket === "risky")
+      risky.push(statement);
+    for (const surface of surfaceTargets) {
+      const list = surfaces[surface];
+      if (Array.isArray(list)) {
+        list.push(statement);
+      }
+    }
+  }
+  const summary = [
+    `Analyzed ${intent.changes.length} change(s).`,
+    `Breaks: ${breaks.length}.`,
+    `Must change: ${mustChange.length}.`,
+    `Risky: ${risky.length}.`
+  ].join(" ");
+  return {
+    reportId,
+    patchId,
+    summary,
+    breaks,
+    mustChange,
+    risky,
+    surfaces
+  };
+}
+// src/project-management-sync.ts
+function buildProjectManagementSyncPayload(params) {
+  const options = params.options ?? {};
+  const items = buildWorkItemsFromTickets(params.tickets, options);
+  const summary = options.includeSummary ? buildSummaryWorkItem({
+    question: params.question,
+    tickets: params.tickets,
+    patchIntent: params.patchIntent,
+    impact: params.impact,
+    title: options.summaryTitle,
+    baseTags: options.baseTags
+  }) : undefined;
+  return { summary, items };
+}
+function buildWorkItemsFromTickets(tickets, options = {}) {
+  return tickets.map((ticket) => ({
+    title: ticket.title,
+    description: renderTicketDescription(ticket),
+    type: "task",
+    priority: mapPriority(ticket.priority, options.defaultPriority),
+    tags: mergeTags(options.baseTags, ticket.tags),
+    externalId: ticket.ticketId
+  }));
+}
+function buildSummaryWorkItem(params) {
+  return {
+    title: params.title ?? "Product Intent Summary",
+    description: renderSummaryMarkdown(params),
+    type: "summary",
+    tags: mergeTags(params.baseTags, ["product-intent", "summary"])
+  };
+}
+function renderTicketDescription(ticket) {
+  const lines = [
+    ticket.summary,
+    "",
+    "Acceptance Criteria:",
+    ...ticket.acceptanceCriteria.map((criterion) => `- ${criterion}`)
+  ];
+  if (ticket.evidenceIds.length > 0) {
+    lines.push("", `Evidence: ${ticket.evidenceIds.join(", ")}`);
+  }
+  return lines.join(`
+`);
+}
+function renderSummaryMarkdown(params) {
+  const lines = [`# ${params.question}`, "", "## Top Tickets"];
+  for (const ticket of params.tickets) {
+    lines.push(`- ${ticket.title}`);
+  }
+  if (params.patchIntent) {
+    lines.push("", "## Patch Intent", `Feature: ${params.patchIntent.featureKey}`);
+    params.patchIntent.changes.forEach((change) => {
+      lines.push(`- ${change.type}: ${change.target}`);
+    });
+  }
+  if (params.impact) {
+    lines.push("", "## Impact Summary", params.impact.summary);
+  }
+  return lines.join(`
+`);
+}
+function mapPriority(priority, fallback) {
+  if (!priority)
+    return fallback;
+  switch (priority) {
+    case "high":
+      return "high";
+    case "medium":
+      return "medium";
+    case "low":
+      return "low";
+    default:
+      return fallback;
+  }
+}
+function mergeTags(baseTags, tags) {
+  const merged = new Set;
+  (baseTags ?? []).forEach((tag) => merged.add(tag));
+  (tags ?? []).forEach((tag) => merged.add(tag));
+  const result = [...merged];
+  return result.length > 0 ? result : undefined;
+}
 // src/prompts.ts
 function formatEvidenceForModel(chunks, maxChars = 900) {
   const safe = chunks.map((chunk) => ({
@@ -322,147 +523,30 @@ Return JSON:
 ${JSON_ONLY_RULES}
 `.trim();
 }
-// src/ticket-prompts.ts
-function promptExtractEvidenceFindings(params) {
-  return `
-You are extracting evidence findings grounded in transcript excerpts.
-
-Question:
-${params.question}
-
-Evidence:
-${params.evidenceJSON}
-
-Return JSON:
-{
-  "findings": [
-    {
-      "findingId": "find_001",
-      "summary": "...",
-      "tags": ["..."],
-      "citations": [{ "chunkId": "...", "quote": "..." }]
-    }
-  ]
-}
+// src/ticket-pipeline.ts
+import {
+  ContractPatchIntentModel as ContractPatchIntentModel2,
+  EvidenceFindingExtractionModel as EvidenceFindingExtractionModel2,
+  ProblemGroupingModel as ProblemGroupingModel2,
+  TicketCollectionModel as TicketCollectionModel2
+} from "@contractspec/lib.contracts-spec/product-intent/types";
 
-Rules:
-- Produce 8 to 18 findings.
-- Each finding must include at least 1 citation.
-- Summaries must be specific and short.
-- Quotes must be copied character-for-character from the chunk text (no paraphrasing, no ellipses).
-- Preserve punctuation, smart quotes, and special hyphens exactly as shown in the chunk text.
-${CITATION_RULES}
-${JSON_ONLY_RULES}
-  `.trim();
-}
-function promptGroupProblems(params) {
-  const allowed = JSON.stringify({ findingIds: params.findingIds }, null, 2);
-  return `
-You are grouping evidence findings into problem statements.
-
-Question:
-${params.question}
-
-Findings:
-${params.findingsJSON}
-
-Allowed finding IDs:
-${allowed}
-
-Return JSON:
-{
-  "problems": [
-    {
-      "problemId": "prob_001",
-      "statement": "...",
-      "evidenceIds": ["find_001"],
-      "tags": ["..."],
-      "severity": "low|medium|high"
-    }
-  ]
-}
-
-Rules:
-- Each problem must reference 1 to 6 evidenceIds.
-- evidenceIds must be drawn from the allowed finding IDs.
-- Keep statements short and actionable.
-${JSON_ONLY_RULES}
-  `.trim();
-}
-function promptGenerateTickets(params) {
-  return `
-You are generating implementation tickets grounded in evidence.
-
-Question:
-${params.question}
-
-Problems:
-${params.problemsJSON}
-
-Evidence findings:
-${params.findingsJSON}
-
-Return JSON:
-{
-  "tickets": [
-    {
-      "ticketId": "t_001",
-      "title": "...",
-      "summary": "...",
-      "evidenceIds": ["find_001"],
-      "acceptanceCriteria": ["..."]
-    }
-  ]
-}
-
-Rules:
-- 1 to 2 tickets per problem.
-- Every ticket must include evidenceIds and acceptanceCriteria.
-- Acceptance criteria must be testable.
-- Each acceptanceCriteria item must be <= 160 characters.
-${JSON_ONLY_RULES}
-  `.trim();
-}
-function promptSuggestPatchIntent(params) {
-  return `
-You are generating a ContractPatchIntent from an evidence-backed ticket.
-
-Ticket:
-${params.ticketJSON}
-
-Return JSON:
-{
-  "featureKey": "feature_slug",
-  "changes": [
-    { "type": "add_field|remove_field|rename_field|add_event|update_event|add_operation|update_operation|update_form|update_policy|add_enum_value|remove_enum_value|other", "target": "string", "detail": "string" }
-  ],
-  "acceptanceCriteria": ["..."]
-}
-
-Rules:
-- Keep changes <= 8.
-- Each change must be concrete and scoped.
-- Acceptance criteria must be testable and derived from the ticket.
-- Each acceptanceCriteria item must be <= 140 characters.
-${JSON_ONLY_RULES}
-  `.trim();
-}
-// src/validators.ts
-import {
-  CitationModel,
-  ContractPatchIntentModel,
-  ImpactReportModel,
-  InsightExtractionModel,
-  OpportunityBriefModel,
-  TaskPackModel
-} from "@contractspec/lib.contracts-spec/product-intent/types";
-function assertStringLength(value, path, bounds) {
-  if (bounds.min !== undefined && value.length < bounds.min) {
-    throw new Error(`Expected ${path} to be at least ${bounds.min} characters, got ${value.length}`);
-  }
-  if (bounds.max !== undefined && value.length > bounds.max) {
-    throw new Error(`Expected ${path} to be at most ${bounds.max} characters, got ${value.length}`);
-  }
+// src/validators.ts
+import {
+  CitationModel,
+  ContractPatchIntentModel,
+  ImpactReportModel,
+  InsightExtractionModel,
+  OpportunityBriefModel,
+  TaskPackModel
+} from "@contractspec/lib.contracts-spec/product-intent/types";
+function assertStringLength(value, path, bounds) {
+  if (bounds.min !== undefined && value.length < bounds.min) {
+    throw new Error(`Expected ${path} to be at least ${bounds.min} characters, got ${value.length}`);
+  }
+  if (bounds.max !== undefined && value.length > bounds.max) {
+    throw new Error(`Expected ${path} to be at most ${bounds.max} characters, got ${value.length}`);
+  }
 }
 function assertArrayLength(value, path, bounds) {
   if (bounds.min !== undefined && value.length < bounds.min) {
@@ -720,6 +804,231 @@ function buildRepairPromptWithOutput(error, previousOutput, maxOutputChars = 400
   ].join(`
 `);
 }
+
+// src/ticket-pipeline-runner.ts
+var DEFAULT_MAX_ATTEMPTS = 2;
+function timestamp() {
+  return new Date().toISOString();
+}
+function toErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+async function safeLog(logger, entry) {
+  if (!logger)
+    return;
+  try {
+    await logger.log(entry);
+  } catch {}
+}
+async function runWithValidation(options) {
+  const maxAttempts = Math.max(1, options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS);
+  let attempt = 0;
+  let lastError;
+  let lastRaw = "";
+  let currentPrompt = options.prompt;
+  while (attempt < maxAttempts) {
+    attempt += 1;
+    await safeLog(options.logger, {
+      stage: options.stage,
+      phase: "request",
+      attempt,
+      prompt: currentPrompt,
+      timestamp: timestamp()
+    });
+    let raw;
+    try {
+      raw = await options.modelRunner.generateJson(currentPrompt);
+    } catch (error) {
+      lastError = toErrorMessage(error);
+      await safeLog(options.logger, {
+        stage: options.stage,
+        phase: "model_error",
+        attempt,
+        prompt: currentPrompt,
+        error: lastError,
+        timestamp: timestamp()
+      });
+      throw new Error(`[${options.stage}] Model error: ${lastError}`);
+    }
+    await safeLog(options.logger, {
+      stage: options.stage,
+      phase: "response",
+      attempt,
+      prompt: currentPrompt,
+      response: raw,
+      timestamp: timestamp()
+    });
+    try {
+      return options.validate(raw);
+    } catch (error) {
+      lastError = toErrorMessage(error);
+      lastRaw = raw;
+      if (options.repair) {
+        const repaired = options.repair(raw, lastError);
+        if (repaired && repaired !== raw) {
+          await safeLog(options.logger, {
+            stage: options.stage,
+            phase: "repair",
+            attempt,
+            prompt: currentPrompt,
+            response: repaired,
+            error: lastError,
+            timestamp: timestamp()
+          });
+          try {
+            return options.validate(repaired);
+          } catch (repairError) {
+            lastError = toErrorMessage(repairError);
+            lastRaw = repaired;
+          }
+        }
+      }
+      await safeLog(options.logger, {
+        stage: options.stage,
+        phase: "validation_error",
+        attempt,
+        prompt: currentPrompt,
+        response: lastRaw,
+        error: lastError,
+        timestamp: timestamp()
+      });
+      currentPrompt = [
+        options.prompt,
+        buildRepairPromptWithOutput(lastError, lastRaw)
+      ].join(`
+
+`);
+    }
+  }
+  throw new Error(`[${options.stage}] Validation failed after ${maxAttempts} attempt(s): ${lastError ?? "unknown error"}`);
+}
+
+// src/ticket-prompts.ts
+function promptExtractEvidenceFindings(params) {
+  return `
+You are extracting evidence findings grounded in transcript excerpts.
+
+Question:
+${params.question}
+
+Evidence:
+${params.evidenceJSON}
+
+Return JSON:
+{
+  "findings": [
+    {
+      "findingId": "find_001",
+      "summary": "...",
+      "tags": ["..."],
+      "citations": [{ "chunkId": "...", "quote": "..." }]
+    }
+  ]
+}
+
+Rules:
+- Produce 8 to 18 findings.
+- Each finding must include at least 1 citation.
+- Summaries must be specific and short.
+- Quotes must be copied character-for-character from the chunk text (no paraphrasing, no ellipses).
+- Preserve punctuation, smart quotes, and special hyphens exactly as shown in the chunk text.
+${CITATION_RULES}
+${JSON_ONLY_RULES}
+  `.trim();
+}
+function promptGroupProblems(params) {
+  const allowed = JSON.stringify({ findingIds: params.findingIds }, null, 2);
+  return `
+You are grouping evidence findings into problem statements.
+
+Question:
+${params.question}
+
+Findings:
+${params.findingsJSON}
+
+Allowed finding IDs:
+${allowed}
+
+Return JSON:
+{
+  "problems": [
+    {
+      "problemId": "prob_001",
+      "statement": "...",
+      "evidenceIds": ["find_001"],
+      "tags": ["..."],
+      "severity": "low|medium|high"
+    }
+  ]
+}
+
+Rules:
+- Each problem must reference 1 to 6 evidenceIds.
+- evidenceIds must be drawn from the allowed finding IDs.
+- Keep statements short and actionable.
+${JSON_ONLY_RULES}
+  `.trim();
+}
+function promptGenerateTickets(params) {
+  return `
+You are generating implementation tickets grounded in evidence.
+
+Question:
+${params.question}
+
+Problems:
+${params.problemsJSON}
+
+Evidence findings:
+${params.findingsJSON}
+
+Return JSON:
+{
+  "tickets": [
+    {
+      "ticketId": "t_001",
+      "title": "...",
+      "summary": "...",
+      "evidenceIds": ["find_001"],
+      "acceptanceCriteria": ["..."]
+    }
+  ]
+}
+
+Rules:
+- 1 to 2 tickets per problem.
+- Every ticket must include evidenceIds and acceptanceCriteria.
+- Acceptance criteria must be testable.
+- Each acceptanceCriteria item must be <= 160 characters.
+${JSON_ONLY_RULES}
+  `.trim();
+}
+function promptSuggestPatchIntent(params) {
+  return `
+You are generating a ContractPatchIntent from an evidence-backed ticket.
+
+Ticket:
+${params.ticketJSON}
+
+Return JSON:
+{
+  "featureKey": "feature_slug",
+  "changes": [
+    { "type": "add_field|remove_field|rename_field|add_event|update_event|add_operation|update_operation|update_form|update_policy|add_enum_value|remove_enum_value|other", "target": "string", "detail": "string" }
+  ],
+  "acceptanceCriteria": ["..."]
+}
+
+Rules:
+- Keep changes <= 8.
+- Each change must be concrete and scoped.
+- Acceptance criteria must be testable and derived from the ticket.
+- Each acceptanceCriteria item must be <= 140 characters.
+${JSON_ONLY_RULES}
+  `.trim();
+}
+
 // src/ticket-validators.ts
 import {
   EvidenceFindingExtractionModel,
@@ -819,122 +1128,17 @@ function validateTicketCollection(raw, findings) {
     });
     for (const criterion of ticket.acceptanceCriteria) {
       assertStringLength2(criterion, "tickets[].acceptanceCriteria[]", {
-        min: 1,
-        max: 280
-      });
-    }
-    if (ticket.tags) {
-      for (const tag of ticket.tags) {
-        assertStringLength2(tag, "tickets[].tags[]", { min: 1, max: 48 });
-      }
-    }
-  }
-  return data;
-}
-// src/ticket-pipeline.ts
-import {
-  ContractPatchIntentModel as ContractPatchIntentModel2,
-  EvidenceFindingExtractionModel as EvidenceFindingExtractionModel2,
-  ProblemGroupingModel as ProblemGroupingModel2,
-  TicketCollectionModel as TicketCollectionModel2
-} from "@contractspec/lib.contracts-spec/product-intent/types";
-
-// src/ticket-pipeline-runner.ts
-var DEFAULT_MAX_ATTEMPTS = 2;
-function timestamp() {
-  return new Date().toISOString();
-}
-function toErrorMessage(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-async function safeLog(logger, entry) {
-  if (!logger)
-    return;
-  try {
-    await logger.log(entry);
-  } catch {}
-}
-async function runWithValidation(options) {
-  const maxAttempts = Math.max(1, options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS);
-  let attempt = 0;
-  let lastError;
-  let lastRaw = "";
-  let currentPrompt = options.prompt;
-  while (attempt < maxAttempts) {
-    attempt += 1;
-    await safeLog(options.logger, {
-      stage: options.stage,
-      phase: "request",
-      attempt,
-      prompt: currentPrompt,
-      timestamp: timestamp()
-    });
-    let raw;
-    try {
-      raw = await options.modelRunner.generateJson(currentPrompt);
-    } catch (error) {
-      lastError = toErrorMessage(error);
-      await safeLog(options.logger, {
-        stage: options.stage,
-        phase: "model_error",
-        attempt,
-        prompt: currentPrompt,
-        error: lastError,
-        timestamp: timestamp()
+        min: 1,
+        max: 280
       });
-      throw new Error(`[${options.stage}] Model error: ${lastError}`);
     }
-    await safeLog(options.logger, {
-      stage: options.stage,
-      phase: "response",
-      attempt,
-      prompt: currentPrompt,
-      response: raw,
-      timestamp: timestamp()
-    });
-    try {
-      return options.validate(raw);
-    } catch (error) {
-      lastError = toErrorMessage(error);
-      lastRaw = raw;
-      if (options.repair) {
-        const repaired = options.repair(raw, lastError);
-        if (repaired && repaired !== raw) {
-          await safeLog(options.logger, {
-            stage: options.stage,
-            phase: "repair",
-            attempt,
-            prompt: currentPrompt,
-            response: repaired,
-            error: lastError,
-            timestamp: timestamp()
-          });
-          try {
-            return options.validate(repaired);
-          } catch (repairError) {
-            lastError = toErrorMessage(repairError);
-            lastRaw = repaired;
-          }
-        }
+    if (ticket.tags) {
+      for (const tag of ticket.tags) {
+        assertStringLength2(tag, "tickets[].tags[]", { min: 1, max: 48 });
       }
-      await safeLog(options.logger, {
-        stage: options.stage,
-        phase: "validation_error",
-        attempt,
-        prompt: currentPrompt,
-        response: lastRaw,
-        error: lastError,
-        timestamp: timestamp()
-      });
-      currentPrompt = [
-        options.prompt,
-        buildRepairPromptWithOutput(lastError, lastRaw)
-      ].join(`
-
-`);
     }
   }
-  throw new Error(`[${options.stage}] Validation failed after ${maxAttempts} attempt(s): ${lastError ?? "unknown error"}`);
+  return data;
 }
 
 // src/ticket-pipeline.ts
@@ -947,7 +1151,7 @@ var TAG_HINTS = {
   performance: ["slow", "latency", "performance"],
   integrations: ["integration", "api", "webhook"]
 };
-function slugify(value) {
+function slugify2(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)+/g, "");
 }
 function pickQuote(text, maxLen = 220) {
@@ -1196,7 +1400,7 @@ function repairPatchIntent(raw) {
 }
 function retrieveChunks(transcript, question, options = {}) {
   const chunkSize = options.chunkSize ?? 800;
-  const sourceId = options.sourceId ?? slugify(question || "transcript");
+  const sourceId = options.sourceId ?? slugify2(question || "transcript");
   const clean = transcript.trim();
   const chunks = [];
   for (let offset = 0, idx = 0;offset < clean.length; idx += 1) {
@@ -1334,7 +1538,7 @@ async function suggestPatch(ticket, options = {}) {
       validate: (raw) => validatePatchIntent(raw)
     });
   }
-  const featureKey = slugify(ticket.title) || "product_intent_ticket";
+  const featureKey = slugify2(ticket.title) || "product_intent_ticket";
   const intent = {
     featureKey,
     changes: [
@@ -1348,207 +1552,6 @@ async function suggestPatch(ticket, options = {}) {
   };
   return validatePatchIntent(JSON.stringify(intent, null, 2));
 }
-// src/impact-engine.ts
-var SURFACE_MAP = {
-  add_field: ["api", "db", "ui", "docs", "tests"],
-  remove_field: ["api", "db", "ui", "docs", "tests"],
-  rename_field: ["api", "db", "ui", "docs", "tests"],
-  add_event: ["api", "workflows", "docs", "tests"],
-  update_event: ["api", "workflows", "docs", "tests"],
-  add_operation: ["api", "ui", "workflows", "docs", "tests"],
-  update_operation: ["api", "ui", "workflows", "docs", "tests"],
-  update_form: ["ui", "docs", "tests"],
-  update_policy: ["policy", "api", "workflows", "docs", "tests"],
-  add_enum_value: ["api", "db", "ui", "docs", "tests"],
-  remove_enum_value: ["api", "db", "ui", "docs", "tests"],
-  other: ["docs", "tests"]
-};
-var BUCKET_MAP = {
-  remove_field: "breaks",
-  rename_field: "breaks",
-  remove_enum_value: "breaks",
-  update_operation: "mustChange",
-  update_event: "mustChange",
-  update_policy: "mustChange",
-  update_form: "risky",
-  add_field: "risky",
-  add_event: "risky",
-  add_operation: "risky",
-  add_enum_value: "risky",
-  other: "risky"
-};
-function slugify2(value) {
-  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)+/g, "");
-}
-function buildTokens(change) {
-  const combined = `${change.type} ${change.target} ${change.detail}`;
-  const tokens = combined.split(/[^a-zA-Z0-9]+/).map((token) => token.trim()).filter((token) => token.length >= 3);
-  return Array.from(new Set(tokens.map((token) => token.toLowerCase()))).slice(0, 8);
-}
-function scanTokens(tokens, files, maxHits) {
-  const hits = [];
-  const lowerTokens = tokens.map((token) => token.toLowerCase());
-  for (const file of files) {
-    const haystack = file.content.toLowerCase();
-    if (lowerTokens.some((token) => haystack.includes(token))) {
-      hits.push(file.path);
-    }
-    if (hits.length >= maxHits)
-      break;
-  }
-  return hits;
-}
-function formatRefs(tokens, repoFiles, maxHits = 3) {
-  if (!repoFiles || repoFiles.length === 0) {
-    return "refs: (no repo scan)";
-  }
-  const hits = scanTokens(tokens, repoFiles, maxHits);
-  if (!hits.length)
-    return "refs: none";
-  return `refs: ${hits.join(", ")}`;
-}
-function humanizeChange(change) {
-  const label = change.type.replace(/_/g, " ");
-  return `${label} ${change.target}`;
-}
-function buildStatement(change, refs, surfaces) {
-  const reason = change.detail || `touches ${surfaces.join(", ")}`;
-  return `${humanizeChange(change)} because ${reason} (${refs})`;
-}
-function impactEngine(intent, options = {}) {
-  const reportId = options.reportId ?? `impact-${slugify2(intent.featureKey)}`;
-  const patchId = options.patchId ?? `patch-${slugify2(intent.featureKey)}`;
-  const maxHitsPerChange = options.maxHitsPerChange ?? 3;
-  const breaks = [];
-  const mustChange = [];
-  const risky = [];
-  const surfaces = {
-    api: [],
-    db: [],
-    ui: [],
-    workflows: [],
-    policy: [],
-    docs: [],
-    tests: []
-  };
-  for (const change of intent.changes) {
-    const bucket = BUCKET_MAP[change.type] ?? "risky";
-    const surfaceTargets = SURFACE_MAP[change.type] ?? ["docs", "tests"];
-    const tokens = buildTokens(change);
-    const refs = formatRefs(tokens, options.repoFiles, maxHitsPerChange);
-    const statement = buildStatement(change, refs, surfaceTargets);
-    if (bucket === "breaks")
-      breaks.push(statement);
-    if (bucket === "mustChange")
-      mustChange.push(statement);
-    if (bucket === "risky")
-      risky.push(statement);
-    for (const surface of surfaceTargets) {
-      const list = surfaces[surface];
-      if (Array.isArray(list)) {
-        list.push(statement);
-      }
-    }
-  }
-  const summary = [
-    `Analyzed ${intent.changes.length} change(s).`,
-    `Breaks: ${breaks.length}.`,
-    `Must change: ${mustChange.length}.`,
-    `Risky: ${risky.length}.`
-  ].join(" ");
-  return {
-    reportId,
-    patchId,
-    summary,
-    breaks,
-    mustChange,
-    risky,
-    surfaces
-  };
-}
-// src/project-management-sync.ts
-function buildProjectManagementSyncPayload(params) {
-  const options = params.options ?? {};
-  const items = buildWorkItemsFromTickets(params.tickets, options);
-  const summary = options.includeSummary ? buildSummaryWorkItem({
-    question: params.question,
-    tickets: params.tickets,
-    patchIntent: params.patchIntent,
-    impact: params.impact,
-    title: options.summaryTitle,
-    baseTags: options.baseTags
-  }) : undefined;
-  return { summary, items };
-}
-function buildWorkItemsFromTickets(tickets, options = {}) {
-  return tickets.map((ticket) => ({
-    title: ticket.title,
-    description: renderTicketDescription(ticket),
-    type: "task",
-    priority: mapPriority(ticket.priority, options.defaultPriority),
-    tags: mergeTags(options.baseTags, ticket.tags),
-    externalId: ticket.ticketId
-  }));
-}
-function buildSummaryWorkItem(params) {
-  return {
-    title: params.title ?? "Product Intent Summary",
-    description: renderSummaryMarkdown(params),
-    type: "summary",
-    tags: mergeTags(params.baseTags, ["product-intent", "summary"])
-  };
-}
-function renderTicketDescription(ticket) {
-  const lines = [
-    ticket.summary,
-    "",
-    "Acceptance Criteria:",
-    ...ticket.acceptanceCriteria.map((criterion) => `- ${criterion}`)
-  ];
-  if (ticket.evidenceIds.length > 0) {
-    lines.push("", `Evidence: ${ticket.evidenceIds.join(", ")}`);
-  }
-  return lines.join(`
-`);
-}
-function renderSummaryMarkdown(params) {
-  const lines = [`# ${params.question}`, "", "## Top Tickets"];
-  for (const ticket of params.tickets) {
-    lines.push(`- ${ticket.title}`);
-  }
-  if (params.patchIntent) {
-    lines.push("", "## Patch Intent", `Feature: ${params.patchIntent.featureKey}`);
-    params.patchIntent.changes.forEach((change) => {
-      lines.push(`- ${change.type}: ${change.target}`);
-    });
-  }
-  if (params.impact) {
-    lines.push("", "## Impact Summary", params.impact.summary);
-  }
-  return lines.join(`
-`);
-}
-function mapPriority(priority, fallback) {
-  if (!priority)
-    return fallback;
-  switch (priority) {
-    case "high":
-      return "high";
-    case "medium":
-      return "medium";
-    case "low":
-      return "low";
-    default:
-      return fallback;
-  }
-}
-function mergeTags(baseTags, tags) {
-  const merged = new Set;
-  (baseTags ?? []).forEach((tag) => merged.add(tag));
-  (tags ?? []).forEach((tag) => merged.add(tag));
-  const result = [...merged];
-  return result.length > 0 ? result : undefined;
-}
 export {
   validateTicketCollection,
   validateTaskPack,