@codedrifters/configulator 0.0.275 → 0.0.277

package/lib/index.js

@@ -246,16 +246,11 @@ __export(index_exports, {
   DEFAULT_TYPE_LABELS: () => DEFAULT_TYPE_LABELS,
   DEFAULT_UNBLOCK_COMMENT_TEMPLATE: () => DEFAULT_UNBLOCK_COMMENT_TEMPLATE,
   DEFAULT_UNBLOCK_DEPENDENTS_ENABLED: () => DEFAULT_UNBLOCK_DEPENDENTS_ENABLED,
-  DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS: () => DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS,
-  DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER: () => DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER,
-  DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER: () => DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER,
-  DEFAULT_WORKFLOW_DIAGRAMS_ENABLED: () => DEFAULT_WORKFLOW_DIAGRAMS_ENABLED,
-  DEFAULT_WORKFLOW_DIAGRAMS_PATH: () => DEFAULT_WORKFLOW_DIAGRAMS_PATH,
-  DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE: () => DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE,
   DOCS_SYNC_AUDIT_SCHEMA_VERSION: () => DOCS_SYNC_AUDIT_SCHEMA_VERSION,
   JsiiFaker: () => JsiiFaker,
   LAYOUT_ENFORCEMENT: () => LAYOUT_ENFORCEMENT,
   LAYOUT_ROOT_BY_PROJECT_TYPE: () => LAYOUT_ROOT_BY_PROJECT_TYPE,
+  MAX_LABEL_DESCRIPTION_LENGTH: () => MAX_LABEL_DESCRIPTION_LENGTH,
   MCP_TRANSPORT: () => MCP_TRANSPORT,
   MERGE_METHODS: () => MERGE_METHODS,
   MIMIMUM_RELEASE_AGE: () => MIMIMUM_RELEASE_AGE,
@@ -326,7 +321,11 @@ __export(index_exports, {
   classifyRun: () => classifyRun,
   companyProfileBundle: () => companyProfileBundle,
   compileFencedSamples: () => compileFencedSamples,
+  createApiDiffCheck: () => createApiDiffCheck,
+  createReferenceMismatchCheck: () => createReferenceMismatchCheck,
+  createTsdocCoverageCheck: () => createTsdocCoverageCheck,
   customerProfileBundle: () => customerProfileBundle,
+  diffApiRollups: () => diffApiRollups,
   docsSyncBundle: () => docsSyncBundle,
   emptyCategoryBuckets: () => emptyCategoryBuckets,
   extractApiProcedure: () => extractApiProcedure,
@@ -341,11 +340,13 @@ __export(index_exports, {
   maintenanceAuditBundle: () => maintenanceAuditBundle,
   meetingAnalysisBundle: () => meetingAnalysisBundle,
   orchestratorBundle: () => orchestratorBundle,
+  parseApiRollup: () => parseApiRollup,
   peopleProfileBundle: () => peopleProfileBundle,
   persistAuditReport: () => persistAuditReport,
   pnpmBundle: () => pnpmBundle,
   prReviewBundle: () => prReviewBundle,
   projenBundle: () => projenBundle,
+  referenceRecordToFinding: () => referenceRecordToFinding,
   regulatoryResearchBundle: () => regulatoryResearchBundle,
   renderAgentTierCaseStatement: () => renderAgentTierCaseStatement,
   renderAgentTierSection: () => renderAgentTierSection,
@@ -382,10 +383,6 @@ __export(index_exports, {
   renderSourceTierExamples: () => renderSourceTierExamples,
   renderUnblockDependentsScript: () => renderUnblockDependentsScript,
   renderUnblockDependentsSection: () => renderUnblockDependentsSection,
-  renderWorkflowDiagramsBundleHook: () => renderWorkflowDiagramsBundleHook,
-  renderWorkflowDiagramsCheckerScript: () => renderWorkflowDiagramsCheckerScript,
-  renderWorkflowDiagramsRuleContent: () => renderWorkflowDiagramsRuleContent,
-  renderWorkflowDiagramsStarterPage: () => renderWorkflowDiagramsStarterPage,
   requirementsAnalystBundle: () => requirementsAnalystBundle,
   requirementsReviewerBundle: () => requirementsReviewerBundle,
   requirementsWriterBundle: () => requirementsWriterBundle,
@@ -408,11 +405,11 @@ __export(index_exports, {
   resolveTemplateVariables: () => resolveTemplateVariables,
   resolveTypeScriptProjectOutdir: () => resolveTypeScriptProjectOutdir,
   resolveUnblockDependents: () => resolveUnblockDependents,
-  resolveWorkflowDiagrams: () => resolveWorkflowDiagrams,
   runScan: () => runScan,
   slackBundle: () => slackBundle,
   softwareProfileBundle: () => softwareProfileBundle,
   standardsResearchBundle: () => standardsResearchBundle,
+  tsdocRecordToFindings: () => tsdocRecordToFindings,
   turborepoBundle: () => turborepoBundle,
   typescriptBundle: () => typescriptBundle,
   validateAgentTierConfig: () => validateAgentTierConfig,
@@ -427,7 +424,6 @@ __export(index_exports, {
   validateSkillEvalsConfig: () => validateSkillEvalsConfig,
   validateStarlightSingleton: () => validateStarlightSingleton,
   validateUnblockDependentsConfig: () => validateUnblockDependentsConfig,
-  validateWorkflowDiagramsConfig: () => validateWorkflowDiagramsConfig,
   vitestBundle: () => vitestBundle
 });
 module.exports = __toCommonJS(index_exports);
@@ -1196,7 +1192,7 @@ var agendaBundle = {
     {
       name: "agenda:finalize",
       color: "BFDADC",
-      description: "Phase 2: incorporate late-added items, register in the meetings index, cross-link related docs, and lock the agenda"
+      description: "Phase 2: register in meetings index, cross-link related docs, and lock the agenda before the meeting"
     }
   ]
 };
@@ -3043,442 +3039,6 @@ function assertValidProductContextPath(value) {
   }
 }
 
-// src/agent/bundles/workflow-diagrams.ts
-var DEFAULT_WORKFLOW_DIAGRAMS_ENABLED = true;
-var DEFAULT_WORKFLOW_DIAGRAMS_PATH = "docs/src/content/docs/agents/workflows.md";
-var DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS = [
-  "packages/@codedrifters/configulator/src/agent/bundles/**/*.ts",
-  ".claude/agents/**/*.md",
-  ".claude/skills/**/*.md"
-];
-var DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER = false;
-var DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER = false;
-var DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE = true;
-function resolveWorkflowDiagrams(config) {
-  const diagramsPath = config?.diagramsPath ?? DEFAULT_WORKFLOW_DIAGRAMS_PATH;
-  assertValidDiagramsPath(diagramsPath);
-  const bundlePathPatterns = config?.bundlePathPatterns ?? DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS;
-  assertValidBundlePathPatterns2(bundlePathPatterns);
-  return {
-    enabled: config?.enabled ?? DEFAULT_WORKFLOW_DIAGRAMS_ENABLED,
-    diagramsPath,
-    bundlePathPatterns,
-    emitStarterDiagram: config?.emitStarterDiagram ?? DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER,
-    emitChecker: config?.emitChecker ?? DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER,
-    requireDiagramUpdate: config?.requireDiagramUpdate ?? DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE
-  };
-}
-function validateWorkflowDiagramsConfig(config) {
-  return resolveWorkflowDiagrams(config);
-}
-function renderWorkflowDiagramsRuleContent(wd) {
-  if (!wd.enabled) {
-    return [
-      "# Workflow Diagrams",
-      "",
-      "**The workflow-diagrams convention is disabled in this project.**",
-      "Agents may change bundle or agent source files without updating",
-      "any diagrams page. When diagrams fall behind the prose, humans",
-      "must reconcile them manually.",
-      "",
-      "Enable the convention via",
-      "`AgentConfigOptions.workflowDiagrams.enabled = true`."
-    ].join("\n");
-  }
-  const requirementVerb = wd.requireDiagramUpdate ? "MUST" : "SHOULD";
-  const lines = [
-    "# Workflow Diagrams",
-    "",
-    "This project maintains a single hand-authored workflow-diagrams",
-    "page that visualises every agent's phases, its decision points,",
-    "and every cross-agent handoff. Prose scattered across rule files",
-    "and agent prompts describes each handoff in isolation; the",
-    "diagrams page is the single visual reference that shows the",
-    "whole pipeline at once.",
-    "",
-    "Diagrams are **hand-authored for readability**, not",
-    "auto-generated. A machine-generated graph of bundle dependencies",
-    "would technically stay in sync, but would not communicate the",
-    "intent behind each handoff \u2014 so the convention trades",
-    "auto-sync for editorial clarity and enforces sync via the rule",
-    "below.",
-    "",
-    "## Diagrams Page",
-    "",
-    `The workflow-diagrams page lives at \`${wd.diagramsPath}\`. It`,
-    "follows a stable structure so the sync rule can mechanically",
-    "identify which section matches which bundle:",
-    "",
-    "1. **Master cross-agent diagram** \u2014 one top-level Mermaid",
-    "   flowchart showing every agent as a node and every",
-    "   cross-agent issue-creation or file-consumption handoff as an",
-    "   edge.",
-    "2. **One section per agent / bundle** \u2014 a `## N. <agent-name>`",
-    "   heading followed by a single Mermaid `flowchart TD` diagram",
-    "   that depicts the agent's phase graph (nodes = phases /",
-    "   decisions, edges = transitions, styled end-nodes = commit /",
-    "   PR / done terminals).",
-    "3. **Legend** \u2014 a short table mapping colours and arrow styles",
-    "   to their meanings (dispatcher vs agent vs skill; solid vs",
-    "   dashed arrows for issue-creation vs file-consumption).",
-    "",
-    "Each agent section is independent. Changing one agent's phase",
-    "graph touches only that section; cross-agent handoff changes",
-    "touch the master diagram plus any affected agent sections.",
-    "",
-    "## Diagram-Touched-When-Bundle-Touched Rule",
-    "",
-    `Every change that modifies a bundle's phase graph ${requirementVerb}`,
-    `also update \`${wd.diagramsPath}\` in the same change set. The`,
-    "rule applies when **any** staged file in a commit or PR matches",
-    "one of the bundle-path patterns below:",
-    "",
-    ...wd.bundlePathPatterns.map((p) => `- \`${p}\``),
-    "",
-    "Mechanically: when a change set includes a file matching one of",
-    `the patterns above, it ${requirementVerb} also include a`,
-    `modification to \`${wd.diagramsPath}\`.`,
-    "",
-    "### What counts as a phase-graph change",
-    "",
-    "The rule targets edits that change **what the agent does**, not",
-    "stylistic tweaks. Concretely:",
-    "",
-    "- Adding, removing, or renaming a phase label.",
-    "- Changing a phase's inputs, outputs, or decision branches.",
-    "- Adding or removing a cross-agent handoff (an issue-creation",
-    "  or file-consumption edge between two bundles).",
-    "- Changing the sort order or priority logic that drives",
-    "  dispatcher routing between tiers.",
-    "",
-    "Edits that do **not** require a diagram update:",
-    "",
-    "- Typo fixes, comment tweaks, wording polish in rule prose.",
-    "- Refactors that preserve the exact phase / handoff graph",
-    "  (extracting a helper, renaming an internal variable,",
-    "  reordering imports).",
-    "- Updates to supporting metadata (permissions lists, default",
-    "  paths) that do not change the visible phase flow.",
-    "",
-    "When a change is borderline \u2014 the phase graph is unchanged but",
-    "the diagram's caption or annotation would be more accurate \u2014",
-    "err on the side of updating the diagram. The convention favours",
-    "over-updating over silent drift.",
-    "",
-    "## Authoring Checklist",
-    "",
-    "Authors and reviewers walk the following checklist before",
-    "merging any PR that touches a bundle path:",
-    "",
-    `1. **Did the phase graph change?** If yes, update \`${wd.diagramsPath}\``,
-    "   in the same PR \u2014 both the affected agent section and, if the",
-    "   change added or removed a cross-agent handoff, the master",
-    "   diagram.",
-    "2. **Did the diagram render?** Preview the Mermaid block locally",
-    "   (or via the docs site's dev server) and confirm it renders",
-    "   without syntax errors.",
-    `3. **Is the section heading stable?** Each agent section uses a`,
-    "   `## N. <agent-name>` heading where `<agent-name>` matches the",
-    "   bundle name / agent prompt filename. Keep the headings stable",
-    "   \u2014 downstream tooling may match on them.",
-    "4. **Does the legend still apply?** If a new arrow style or node",
-    "   colour was introduced, document it in the legend.",
-    ""
-  ];
-  if (wd.emitChecker) {
-    lines.push(
-      "## Automated Check",
-      "",
-      `The bundled \`.claude/procedures/check-workflow-diagrams.sh\``,
-      "helper enforces the rule mechanically. Given a set of changed",
-      "files (as a newline-separated list on stdin, or positional",
-      `arguments), it fails non-zero when any file matches a`,
-      `bundle-path pattern and \`${wd.diagramsPath}\` is not also in`,
-      "the list. Wire it into a pre-commit hook or CI job as needed:",
-      "",
-      "```bash",
-      "# Pre-commit (staged files):",
-      "git diff --cached --name-only \\",
-      "  | .claude/procedures/check-workflow-diagrams.sh",
-      "",
-      "# CI (branch-vs-base):",
-      "git diff --name-only origin/main...HEAD \\",
-      "  | .claude/procedures/check-workflow-diagrams.sh",
-      "```",
-      "",
-      "The helper exits with a descriptive diagnostic on failure, so",
-      "it plugs directly into any hook framework without further",
-      "glue. It exits `0` when no bundle files were touched or when",
-      "the diagrams file is also present in the change set.",
-      ""
-    );
-  }
-  lines.push(
-    "## Out of Scope",
-    "",
-    "The convention intentionally does not:",
-    "",
-    "- Auto-generate the diagrams \u2014 readability is the point.",
-    "- Enforce a specific Mermaid sub-grammar beyond `flowchart TD`",
-    "  for per-agent sections. Sequence diagrams, state diagrams, or",
-    "  class diagrams are fine for bespoke sections as long as they",
-    "  render.",
-    "- Gate every unrelated cleanup PR on a diagram touch. The rule",
-    "  targets phase-graph-affecting edits; pure cleanups documented",
-    "  as such are exempt."
-  );
-  return lines.join("\n");
-}
-function renderWorkflowDiagramsBundleHook(wd, bundleLabel) {
-  if (!wd.enabled) {
-    return "";
-  }
-  const verb = wd.requireDiagramUpdate ? "must" : "should";
-  return [
-    "## Workflow Diagram",
-    "",
-    `Every ${bundleLabel} change that modifies the phase graph,`,
-    "decision branches, or cross-agent handoffs documented by this",
-    `bundle ${verb} also update the matching section in`,
-    `\`${wd.diagramsPath}\` in the same PR. See the`,
-    "`workflow-diagrams-convention` rule for the full authoring",
-    "checklist, the path patterns the rule covers, and what counts",
-    "as a phase-graph change vs. a cosmetic edit."
-  ].join("\n");
-}
-function renderWorkflowDiagramsStarterPage(_wd) {
-  return [
-    "---",
-    "title: Agent Workflows",
-    "description: Hand-authored Mermaid diagrams for every agent pipeline and every cross-agent handoff.",
-    "---",
-    "",
-    "# Agent Workflows",
-    "",
-    "Each diagram shows every input, decision point, output path, and",
-    "downstream issue created by the agent. Solid arrows are issue-",
-    "creation handoffs; dashed arrows are file-consumption handoffs.",
-    "",
-    "Update this page in the same PR that changes a bundle's phase",
-    "graph \u2014 see the `workflow-diagrams-convention` rule for the full",
-    "contract.",
-    "",
-    "## Master Cross-Agent Diagram",
-    "",
-    "```mermaid",
-    "flowchart TB",
-    "    %% Replace the placeholder below with the real agent ecosystem.",
-    "    DISPATCHER[Dispatcher]",
-    "    AGENT_A[Agent A]",
-    "    AGENT_B[Agent B]",
-    "    DISPATCHER --> AGENT_A",
-    "    DISPATCHER --> AGENT_B",
-    "    AGENT_A -->|issue-creation| AGENT_B",
-    "    AGENT_B -.->|file-consumption| AGENT_A",
-    "```",
-    "",
-    "## 1. Example Agent",
-    "",
-    "```mermaid",
-    "flowchart TD",
-    "    START([Session Start]) --> CLAIM[Claim issue]",
-    "    CLAIM --> PHASE{Phase label?}",
-    "    PHASE -->|phase:a| A1[Phase A work]",
-    "    PHASE -->|phase:b| B1[Phase B work]",
-    "    A1 --> COMMIT[Commit & PR]",
-    "    B1 --> COMMIT",
-    "    COMMIT --> STOP([Stop])",
-    "    style STOP fill:#e8f5e9,stroke:#2e7d32",
-    "```",
-    "",
-    "## Legend",
-    "",
-    "| Style | Meaning |",
-    "|-------|---------|",
-    "| Solid arrow | Issue-creation handoff (agent A creates an issue for agent B) |",
-    "| Dashed arrow | File-consumption handoff (agent A reads files produced by agent B) |",
-    "| Green end-node | Terminal state (session complete) |"
-  ].join("\n");
-}
-function renderWorkflowDiagramsCheckerScript(wd) {
-  const patternsLiteral = wd.bundlePathPatterns.map((p) => `  ${JSON.stringify(p)}`).join("\n");
-  return [
-    "#!/usr/bin/env bash",
-    "# check-workflow-diagrams.sh \u2014 Enforce the diagram-touched-when-bundle-touched rule.",
-    "#",
-    "# Usage:",
-    "#   .claude/procedures/check-workflow-diagrams.sh <file>...",
-    "#   git diff --name-only HEAD | .claude/procedures/check-workflow-diagrams.sh",
-    "#",
-    "# Exits 0 when the workflow-diagrams page was touched alongside any",
-    "# bundle file in the change set, or when no bundle files were touched.",
-    "# Exits non-zero with a descriptive diagnostic on failure.",
-    "#",
-    "# The bundle-path patterns and diagrams path are rendered from the",
-    "# consumer's WorkflowDiagramsConfig at synth time \u2014 do not edit by",
-    "# hand; regenerate via `pnpm exec projen`.",
-    "#",
-    "# Patterns support the `**` recursive-segment wildcard even though",
-    "# bash's native `[[ $file == $glob ]]` pattern matching does not:",
-    "# each glob is converted to a POSIX-extended regex internally and",
-    "# matched with `=~`, so the script works uniformly on bash 3.2",
-    "# (macOS default) and bash 4+ (Linux / CI) without depending on",
-    "# `shopt -s globstar` (which only affects pathname expansion, not",
-    "# `[[ ]]` pattern matching).",
-    "",
-    "set -uo pipefail",
-    "",
-    "err() {",
-    '  printf "check-workflow-diagrams.sh: %s\\n" "$*" >&2',
-    "}",
-    "",
-    `diagrams_path=${JSON.stringify(wd.diagramsPath)}`,
-    "",
-    "# Bundle-path glob patterns. Translated to anchored POSIX-extended",
-    "# regexes at runtime by `glob_to_regex` below so `**` matches",
-    "# recursively across path segments.",
-    "bundle_patterns=(",
-    patternsLiteral,
-    ")",
-    "",
-    "# Convert a bash-style glob into an anchored POSIX-extended regex:",
-    "#   **/   \u2192 (.+/)?   (zero or more path segments plus trailing slash)",
-    "#   **    \u2192 .*       (anywhere, including `/`)",
-    "#   *     \u2192 [^/]*    (single path segment)",
-    "#   ?     \u2192 [^/]     (single non-slash char)",
-    "# Every other char is passed through, with regex metacharacters",
-    "# backslash-escaped so literal `.` / `+` / `(` etc. match themselves.",
-    "glob_to_regex() {",
-    '  local glob="$1"',
-    '  local regex=""',
-    "  local i=0",
-    "  local len=${#glob}",
-    "  while (( i < len )); do",
-    '    local c="${glob:i:1}"',
-    '    if [[ "$c" == "*" ]]; then',
-    '      local next="${glob:i+1:1}"',
-    '      if [[ "$next" == "*" ]]; then',
-    "        # `**` \u2014 recursive segment wildcard.",
-    '        local after="${glob:i+2:1}"',
-    '        if [[ "$after" == "/" ]]; then',
-    '          regex+="(.+/)?"',
-    "          i=$(( i + 3 ))",
-    "        else",
-    '          regex+=".*"',
-    "          i=$(( i + 2 ))",
-    "        fi",
-    "      else",
-    '        regex+="[^/]*"',
-    "        i=$(( i + 1 ))",
-    "      fi",
-    '    elif [[ "$c" == "?" ]]; then',
-    '      regex+="[^/]"',
-    "      i=$(( i + 1 ))",
-    "    else",
-    '      case "$c" in',
-    "        # Regex metacharacters \u2014 escape to match literally.",
-    "        '.'|'+'|'^'|'$'|'('|')'|'{'|'}'|'|'|'['|']'|'\\\\')",
-    '          regex+="\\\\$c"',
-    "          ;;",
-    "        *)",
-    '          regex+="$c"',
-    "          ;;",
-    "      esac",
-    "      i=$(( i + 1 ))",
-    "    fi",
-    "  done",
-    '  printf "^%s$" "$regex"',
-    "}",
-    "",
-    "# Collect the input file list: positional args override stdin.",
-    "if [[ $# -gt 0 ]]; then",
-    '  files=("$@")',
-    "else",
-    "  files=()",
-    "  while IFS= read -r line; do",
-    '    [[ -z "$line" ]] && continue',
-    '    files+=("$line")',
-    "  done",
-    "fi",
-    "",
-    "if [[ ${#files[@]} -eq 0 ]]; then",
-    "  # No input \u2014 nothing to check.",
-    "  exit 0",
-    "fi",
-    "",
-    "# Precompile each bundle pattern to a regex once.",
-    "bundle_regexes=()",
-    'for pattern in "${bundle_patterns[@]}"; do',
-    '  bundle_regexes+=("$(glob_to_regex "$pattern")")',
-    "done",
-    "",
-    "bundle_touched=0",
-    "matched_bundle=''",
-    "diagrams_touched=0",
-    "",
-    'for file in "${files[@]}"; do',
-    '  if [[ "$file" == "$diagrams_path" ]]; then',
-    "    diagrams_touched=1",
-    "    continue",
-    "  fi",
-    '  for regex in "${bundle_regexes[@]}"; do',
-    '    if [[ "$file" =~ $regex ]]; then',
-    "      bundle_touched=1",
-    '      matched_bundle="$file"',
-    "      break",
-    "    fi",
-    "  done",
-    "done",
-    "",
-    'if [[ "$bundle_touched" -eq 1 && "$diagrams_touched" -eq 0 ]]; then',
-    `  err "bundle file '$matched_bundle' was modified but '$diagrams_path' was not"`,
-    '  err "update the workflow-diagrams page in the same change set (see workflow-diagrams-convention rule)"',
-    "  exit 1",
-    "fi",
-    "",
-    "exit 0"
-  ].join("\n");
-}
-function assertValidDiagramsPath(value) {
-  if (typeof value !== "string" || value.trim().length === 0) {
-    throw new Error(
-      `WorkflowDiagramsConfig.diagramsPath must be a non-empty string; got ${JSON.stringify(
-        value
-      )}`
-    );
-  }
-  if (value.startsWith("/")) {
-    throw new Error(
-      `WorkflowDiagramsConfig.diagramsPath must be a repo-relative path (no leading '/'); got ${JSON.stringify(
-        value
-      )}`
-    );
-  }
-}
-function assertValidBundlePathPatterns2(value) {
-  if (!Array.isArray(value)) {
-    throw new Error(
-      `WorkflowDiagramsConfig.bundlePathPatterns must be an array; got ${JSON.stringify(
-        value
-      )}`
-    );
-  }
-  if (value.length === 0) {
-    throw new Error(
-      "WorkflowDiagramsConfig.bundlePathPatterns must not be empty \u2014 supply at least one pattern or omit the field to use the defaults"
-    );
-  }
-  for (const entry of value) {
-    if (typeof entry !== "string" || entry.trim().length === 0) {
-      throw new Error(
-        `WorkflowDiagramsConfig.bundlePathPatterns entries must be non-empty strings; got ${JSON.stringify(
-          entry
-        )}`
-      );
-    }
-  }
-}
-
 // src/agent/bundles/base.ts
 var createPackageSkill = {
   name: "create-package",
@@ -4556,16 +4116,6 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
         },
         tags: ["workflow"]
       },
-      {
-        name: "workflow-diagrams-convention",
-        description: `Workflow-diagrams convention: hand-authored Mermaid page under \`${paths.docsRoot}/agents/workflows.md\` with one diagram per agent plus a master cross-agent diagram, and the diagram-touched-when-bundle-touched rule that keeps the page in sync with every phase-graph or cross-agent-handoff change.`,
-        scope: AGENT_RULE_SCOPE.ALWAYS,
-        content: renderWorkflowDiagramsRuleContent(resolveWorkflowDiagrams()),
-        platforms: {
-          cursor: { exclude: true }
-        },
-        tags: ["workflow"]
-      },
       {
         name: "issue-templates-convention",
         description: `Issue-templates convention: a single hand-authored reference page under \`${paths.docsRoot}/agents/issue-templates.md\` that carries one canonical \`gh issue create\` recipe per downstream phase label, and the reference-don't-inline rule that keeps bundle rules and agent prompts citing that page instead of duplicating full template invocations.`,
@@ -5305,12 +4855,12 @@ function buildBcmWriterBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "bcm:context",
         color: "D4C5F9",
-        description: "Phase 3: fill Project Relevance, Value Stream Mapping, Enabling Software Systems, Roles Involved, and Company Size Applicability"
+        description: "Phase 3: fill Project Relevance, Value Stream Mapping, Software Systems, Roles, and Company Size"
       },
       {
         name: "bcm:connect",
         color: "FEF2C0",
-        description: "Phase 4: cross-link with parent/siblings, update registry and capability-map, open downstream research issues"
+        description: "Phase 4: cross-link parent/siblings, update registry and capability-map, open downstream issues"
       }
     ]
   };
@@ -6305,7 +5855,7 @@ function buildBusinessModelsBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "type:business-model",
         color: "5319E7",
-        description: "Work that authors or updates a Business Model Canvas plus BIZBOK value streams for an industry segment"
+        description: "Authors or updates a Business Model Canvas plus BIZBOK value streams for an industry segment"
       },
       {
         name: "business-models:scan",
@@ -8644,22 +8194,22 @@ function buildCustomerProfileBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "type:customer-profile",
         color: "5319E7",
-        description: "Work that researches a customer archetype: discovery across a scope, deep profile of one archetype, or feature-to-need competitor analysis for one archetype"
+        description: "Researches a customer archetype: discovery, deep profile, or competitor analysis"
       },
       {
         name: "customer:discover",
         color: "C5DEF5",
-        description: "Phase 1: scan existing documentation for customer archetype candidates and write a discovery report; create downstream profile issues"
+        description: "Phase 1: scan docs for archetype candidates, write discovery report, create profile issues"
       },
       {
         name: "customer:profile",
         color: "BFDADC",
-        description: "Phase 2: research one archetype in depth and populate the archetype page with segment, goals, jobs-to-be-done, constraints, buying process, and technology landscape"
+        description: "Phase 2: deep-research one archetype: segment, goals, JTBD, constraints, buying process, tech"
       },
       {
         name: "customer:competitors",
         color: "D4C5F9",
-        description: "Phase 3: map shared feature-matrix rows to archetype needs, identify unmet needs, and hand off req:scan seeds to the requirements-analyst bundle"
+        description: "Phase 3: map feature-matrix rows to archetype needs and hand off req:scan seeds"
       }
     ]
   };
@@ -9526,22 +9076,22 @@ function buildDocsSyncBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "docs-sync:scan",
         color: "C5DEF5",
-        description: "Phase 1: scan code and docs for drift (API diff, TSDoc coverage, reference integrity, link integrity, code-sample compilation)"
+        description: "Phase 1: scan for drift (API diff, TSDoc coverage, references, links, sample compilation)"
       },
       {
         name: "docs-sync:fix",
         color: "BFDADC",
-        description: "Phase 2: apply mechanical idempotent fixes (TSDoc stubs, dead-link updates, registry sync, rename-follow) and file docs:write follow-ups for conceptual changes"
+        description: "Phase 2: apply mechanical fixes and file docs:write follow-ups for conceptual changes"
       },
       {
         name: "docs-sync:advisory",
         color: "FBCA04",
-        description: "Drift detected by docs-sync but does not block the PR; surfaced as a non-blocking note on the sticky comment"
+        description: "Drift detected by docs-sync but does not block the PR; surfaced as a sticky-comment note"
       },
       {
         name: "docs-sync:blocking",
         color: "B60205",
-        description: "Drift detected by docs-sync blocks the PR; applied together with review:human-required so pr-reviewer owns the merge gate"
+        description: "Drift blocks the PR; applied with review:human-required so pr-reviewer owns the merge gate"
       }
     ]
   };
@@ -11136,7 +10686,7 @@ function buildMaintenanceAuditBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "maint:verify",
         color: "D4C5F9",
-        description: "Phase 3: re-run the scan checks scoped to the paths the fix phase touched, compare pre/post findings, and close or re-queue the parent scan"
+        description: "Phase 3: re-run scan checks scoped to fix-phase paths, compare findings, close or re-queue scan"
       }
     ]
   };
@@ -15675,7 +15225,7 @@ function buildPeopleProfileBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "people:followup",
         color: "D4C5F9",
-        description: "Phase 3: cross-link the profile to existing companies, software, and meeting notes, and enqueue follow-up research issues for unprofiled companies and software products"
+        description: "Phase 3: cross-link profile to companies/software/meetings; enqueue follow-up research issues"
       },
       {
         name: "people:refresh",
@@ -18475,22 +18025,22 @@ function buildRegulatoryResearchBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "type:regulatory-research",
         color: "5319E7",
-        description: "Work that researches a regulatory compliance obligation: scan of a jurisdictional landscape, deep-dive on one regulation, or impact analysis against the consuming project"
+        description: "Researches a regulatory obligation: jurisdictional scan, deep-dive, or impact analysis"
       },
       {
         name: "regulatory:scan",
         color: "C5DEF5",
-        description: "Phase 1: enumerate regulations applicable to an industry, jurisdiction, or platform scope; write a scan report; create downstream research issues"
+        description: "Phase 1: enumerate regulations for an industry/jurisdiction/scope; create research issues"
       },
       {
         name: "regulatory:research",
         color: "BFDADC",
-        description: "Phase 2: research one regulation in depth and populate the regulation page with scope, triggers, requirements, jurisdiction variations, enforcement, and penalties"
+        description: "Phase 2: research one regulation in depth (scope, triggers, requirements, enforcement)"
       },
       {
         name: "regulatory:impact",
         color: "D4C5F9",
-        description: "Phase 3: assess product impact against one regulation and hand off actionable obligations as SEC req:scan seeds to the requirements-analyst bundle"
+        description: "Phase 3: assess product impact and hand off SEC req:scan seeds to requirements-analyst"
       }
     ]
   };
@@ -21767,7 +21317,7 @@ function buildRequirementsWriterBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "tier:customer-workflow",
         color: "EDEDED",
-        description: "Architectural tier: customer-configured workflow (business logic tenants configure within the platform)"
+        description: "Architectural tier: customer-configured workflow (business logic tenants configure)"
       },
       {
         name: "tier:consumer-app",
@@ -23167,7 +22717,7 @@ function buildRequirementsReviewerBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "req:deprecate",
         color: "D93F0B",
-        description: "Phase: transition existing requirement documents to Deprecated or Superseded using the requirements-reviewer skill"
+        description: "Phase: transition requirement docs to Deprecated/Superseded via the requirements-reviewer"
       }
     ]
   };
@@ -24821,7 +24371,7 @@ function buildSoftwareProfileBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "type:software-profile",
         color: "0E8A16",
-        description: "Work that produces or maintains a software profile, research notes, feature-matrix rows, or capability mappings"
+        description: "Produces a software profile, research notes, feature-matrix rows, or capability mappings"
       },
       {
         name: "software:research",
@@ -24841,12 +24391,12 @@ function buildSoftwareProfileBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "software:map",
         color: "A2EEEF",
-        description: "Phase 4: map each feature back to the BCM capability model, write the mapping onto the profile, and enqueue `bcm:outline` issues for unmapped features above the configured threshold"
+        description: "Phase 4: map features to the BCM model and enqueue bcm:outline issues for unmapped features"
       },
       {
         name: "software:followup",
         color: "FBCA04",
-        description: "Phase 5: enqueue follow-up research issues for adjacent products, the vendor company, and primary-attribution people surfaced in the profile"
+        description: "Phase 5: enqueue follow-up research for adjacent products, vendor company, and key people"
       }
     ]
   };
@@ -26173,32 +25723,32 @@ function buildStandardsResearchBundle(paths = DEFAULT_AGENT_PATHS) {
       {
         name: "type:standards-research",
         color: "5319E7",
-        description: "Work that researches an interoperability standard: version research, cross-version comparison, extension analysis, or standards-body organization profiling"
+        description: "Researches an interoperability standard: versions, comparison, extension, or org profile"
       },
       {
         name: "standards:scope",
         color: "C5DEF5",
-        description: "Phase 1: plan the research campaign for one standard; write the query plan; create downstream research, compare, and organizations issues"
+        description: "Phase 1: plan a standard's research campaign; write query plan; create downstream issues"
       },
       {
         name: "standards:research",
         color: "BFDADC",
-        description: "Phase 2: research one version of the standard and populate the version page with status, key changes, resources, adoption, and governance touch-points"
+        description: "Phase 2: research one version (status, key changes, resources, adoption, governance)"
       },
       {
         name: "standards:compare",
         color: "D4C5F9",
-        description: "Phase 3: synthesize a cross-version comparison on the standard's overview page \u2014 version timeline, maturity progression, breaking changes, migration paths"
+        description: "Phase 3: synthesize cross-version comparison: timeline, maturity, breaking changes, migration"
       },
       {
         name: "standards:extension",
         color: "FBCA04",
-        description: "Phase 4: analyze the extension mechanism needed for one domain entity whose base-spec mapping is Partial or Gap; hand off a Proposed ADR to the requirements pipeline"
+        description: "Phase 4: analyze extension for one Partial/Gap entity; hand off Proposed ADR to requirements"
       },
       {
         name: "standards:organizations",
         color: "0E8A16",
-        description: "Phase 5: profile one standards-body organization's role in the standard; hand off canonical company and people profiles to the profile bundles"
+        description: "Phase 5: profile one standards-body organization; hand off company/people profile issues"
       }
     ]
   };
@@ -27260,8 +26810,8 @@ var FALLBACKS = {
   monorepoLayoutSeedBlock: ""
 };
 var TEMPLATE_RE = /\{\{(\w+(?:\.\w+)*)\}\}/g;
-function getNestedValue(obj, path7) {
-  const parts = path7.split(".");
+function getNestedValue(obj, path8) {
+  const parts = path8.split(".");
   let current = obj;
   for (const part of parts) {
     if (current == null || typeof current !== "object") {
@@ -27956,26 +27506,6 @@ var SKILL_EVALS_BUNDLE_HOOKS = [
   ["requirements-analyst-workflow", "requirements-analyst"],
   ["requirements-writer-workflow", "write-requirement"]
 ];
-var WORKFLOW_DIAGRAMS_BUNDLE_HOOKS = [
-  ["bcm-writer-workflow", "bcm-writer"],
-  ["business-models-workflow", "business-models"],
-  ["company-profile-workflow", "company-profile"],
-  ["customer-profile-workflow", "customer-profile"],
-  ["industry-discovery-workflow", "industry-discovery"],
-  ["maintenance-audit-workflow", "maintenance-audit"],
-  ["meeting-agenda-workflow", "agenda"],
-  ["meeting-processing-workflow", "meeting-analysis"],
-  ["orchestrator-conventions", "orchestrator"],
-  ["people-profile-workflow", "people-profile"],
-  ["pr-review-workflow", "pr-review"],
-  ["regulatory-research-workflow", "regulatory-research"],
-  ["requirements-analyst-workflow", "requirements-analyst"],
-  ["requirements-reviewer-workflow", "requirements-reviewer"],
-  ["requirements-writer-workflow", "requirements-writer"],
-  ["research-pipeline-workflow", "research-pipeline"],
-  ["software-profile-workflow", "software-profile"],
-  ["standards-research-workflow", "standards-research"]
-];
 var ISSUE_TEMPLATES_BUNDLE_HOOKS = [
   ["bcm-writer-workflow", "bcm-writer"],
   ["business-models-workflow", "business-models"],
@@ -28147,24 +27677,6 @@ var AgentConfig = class _AgentConfig extends import_projen8.Component {
         executable: true
       });
     }
-    const resolvedWorkflowDiagrams = validateWorkflowDiagramsConfig(
-      this.options.workflowDiagrams
-    );
-    if (resolvedWorkflowDiagrams.enabled) {
-      if (resolvedWorkflowDiagrams.emitChecker) {
-        new import_projen8.TextFile(this, ".claude/procedures/check-workflow-diagrams.sh", {
-          lines: renderWorkflowDiagramsCheckerScript(
-            resolvedWorkflowDiagrams
-          ).split("\n"),
-          executable: true
-        });
-      }
-      if (resolvedWorkflowDiagrams.emitStarterDiagram) {
-        new import_projen8.SampleFile(this.project, resolvedWorkflowDiagrams.diagramsPath, {
-          contents: renderWorkflowDiagramsStarterPage(resolvedWorkflowDiagrams)
-        });
-      }
-    }
     const resolvedIssueTemplates = validateIssueTemplatesConfig(
       this.options.issueTemplates
     );
@@ -28477,46 +27989,6 @@ ${hook}`
 
 ---
 
-${hook}`
-        });
-      }
-    }
-    const resolvedWorkflowDiagramsForRules = resolveWorkflowDiagrams(
-      this.options.workflowDiagrams
-    );
-    if (this.options.workflowDiagrams) {
-      const workflowDiagramsRule = ruleMap.get("workflow-diagrams-convention");
-      if (workflowDiagramsRule) {
-        const workflowDiagramsContent = renderWorkflowDiagramsRuleContent(
-          resolvedWorkflowDiagramsForRules
-        );
-        if (workflowDiagramsContent !== workflowDiagramsRule.content) {
-          ruleMap.set("workflow-diagrams-convention", {
-            ...workflowDiagramsRule,
-            content: workflowDiagramsContent
-          });
-        }
-      }
-    }
-    if (resolvedWorkflowDiagramsForRules.enabled) {
-      for (const [ruleName, label] of WORKFLOW_DIAGRAMS_BUNDLE_HOOKS) {
-        const existing = ruleMap.get(ruleName);
-        if (!existing) {
-          continue;
-        }
-        const hook = renderWorkflowDiagramsBundleHook(
-          resolvedWorkflowDiagramsForRules,
-          label
-        );
-        if (hook.length === 0) {
-          continue;
-        }
-        ruleMap.set(ruleName, {
-          ...existing,
-          content: `${existing.content}
-
----
-
 ${hook}`
         });
       }
@@ -29948,9 +29420,388 @@ function auditReportJsonSchema() {
   };
 }
 
+// src/docs-sync/scan/checks/api-diff-check.ts
+function parseApiRollup(rollup) {
+  const fenceContents = extractFirstTsFence(rollup);
+  if (fenceContents === void 0) {
+    return [];
+  }
+  const lines = fenceContents.split("\n");
+  const entries = [];
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("export ")) {
+      i += 1;
+      continue;
+    }
+    const startIndex = i;
+    let buffer = trimmed;
+    let braceDepth = countBraceDelta(trimmed);
+    let endsWithSemicolon = trimmed.endsWith(";");
+    i += 1;
+    while (i < lines.length && !isComplete(buffer, braceDepth, endsWithSemicolon)) {
+      const next = lines[i];
+      const nextTrimmed = next.trim();
+      if (nextTrimmed.length === 0 || nextTrimmed.startsWith("//")) {
+        i += 1;
+        continue;
+      }
+      buffer = `${buffer} ${nextTrimmed}`;
+      braceDepth += countBraceDelta(nextTrimmed);
+      endsWithSemicolon = nextTrimmed.endsWith(";");
+      i += 1;
+    }
+    const normalized = normalizeWhitespace(buffer);
+    const name = extractDeclarationName(normalized);
+    if (name) {
+      entries.push({ name, signature: normalized });
+    }
+    if (name && normalized.startsWith("export {")) {
+      const names = extractExportListNames(normalized);
+      if (names.length > 1) {
+        entries.pop();
+        for (const exportName of names) {
+          entries.push({ name: exportName, signature: normalized });
+        }
+      }
+    }
+    if (i === startIndex) {
+      i += 1;
+    }
+  }
+  const dedup = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (!dedup.has(entry.name)) {
+      dedup.set(entry.name, entry);
+    }
+  }
+  return Array.from(dedup.values()).sort(
+    (a, b) => a.name.localeCompare(b.name)
+  );
+}
+function diffApiRollups(baselineRollup, currentRollup) {
+  const baseline = /* @__PURE__ */ new Map();
+  for (const entry of parseApiRollup(baselineRollup)) {
+    baseline.set(entry.name, entry);
+  }
+  const current = /* @__PURE__ */ new Map();
+  for (const entry of parseApiRollup(currentRollup)) {
+    current.set(entry.name, entry);
+  }
+  const added = [];
+  const removed = [];
+  const changed = [];
+  for (const [name, entry] of current.entries()) {
+    const before = baseline.get(name);
+    if (!before) {
+      added.push(entry);
+      continue;
+    }
+    if (before.signature !== entry.signature) {
+      changed.push(entry);
+    }
+  }
+  for (const [name, entry] of baseline.entries()) {
+    if (!current.has(name)) {
+      removed.push(entry);
+    }
+  }
+  added.sort((a, b) => a.name.localeCompare(b.name));
+  removed.sort((a, b) => a.name.localeCompare(b.name));
+  changed.sort((a, b) => a.name.localeCompare(b.name));
+  return { added, removed, changed };
+}
+function createApiDiffCheck(options) {
+  const baseline = options.baselineRollup;
+  const current = options.currentRollup;
+  const rollupPath = options.rollupPath ?? "";
+  return {
+    name: options.name ?? "apiDiff",
+    run(_context) {
+      const diff = diffApiRollups(baseline, current);
+      const findings = [];
+      for (const entry of diff.added) {
+        findings.push({
+          category: AuditCategory.ApiDiff,
+          severity: AuditSeverity.Mechanical,
+          location: { file: rollupPath, line: 0 },
+          subject: entry.name,
+          details: `New public export \`${entry.name}\` not present in baseline rollup.`,
+          change: "added",
+          symbol: entry.name,
+          fixHint: "stub-tsdoc"
+        });
+      }
+      for (const entry of diff.removed) {
+        findings.push({
+          category: AuditCategory.ApiDiff,
+          severity: AuditSeverity.Advisory,
+          location: { file: rollupPath, line: 0 },
+          subject: entry.name,
+          details: `Public export \`${entry.name}\` was present in baseline rollup but is gone in the current rollup.`,
+          change: "removed",
+          symbol: entry.name
+        });
+      }
+      for (const entry of diff.changed) {
+        findings.push({
+          category: AuditCategory.ApiDiff,
+          severity: AuditSeverity.Advisory,
+          location: { file: rollupPath, line: 0 },
+          subject: entry.name,
+          details: `Public export \`${entry.name}\` signature changed since baseline rollup.`,
+          change: "changed",
+          symbol: entry.name
+        });
+      }
+      return findings;
+    }
+  };
+}
+function extractFirstTsFence(rollup) {
+  const lines = rollup.split("\n");
+  let start = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line === "```ts" || line === "```typescript") {
+      start = i + 1;
+      break;
+    }
+  }
+  if (start < 0) {
+    return void 0;
+  }
+  for (let j = start; j < lines.length; j++) {
+    if (lines[j].trim() === "```") {
+      return lines.slice(start, j).join("\n");
+    }
+  }
+  return lines.slice(start).join("\n");
+}
+function countBraceDelta(line) {
+  let delta = 0;
+  for (const ch of line) {
+    if (ch === "{") {
+      delta += 1;
+    } else if (ch === "}") {
+      delta -= 1;
+    }
+  }
+  return delta;
+}
+function isComplete(buffer, braceDepth, endsWithSemicolon) {
+  if (braceDepth > 0) {
+    return false;
+  }
+  if (endsWithSemicolon) {
+    return true;
+  }
+  return buffer.trimEnd().endsWith("}");
+}
+function normalizeWhitespace(s) {
+  return s.replace(/\s+/g, " ").replace(/\(\s+/g, "(").replace(/\s+\)/g, ")").replace(/\[\s+/g, "[").replace(/\s+\]/g, "]").replace(/\{\s+/g, "{").replace(/\s+\}/g, "}").replace(/\s+,/g, ",").replace(/\s+;/g, ";").replace(/\s+:/g, ":").trim();
+}
+var DECLARATION_KEYWORDS = [
+  "function",
+  "class",
+  "interface",
+  "type",
+  "enum",
+  "const",
+  "let",
+  "var",
+  "namespace",
+  "abstract",
+  "default",
+  "async"
+];
+function extractDeclarationName(declaration) {
+  const tokens = declaration.split(/\s+/);
+  if (tokens.length === 0 || tokens[0] !== "export") {
+    return void 0;
+  }
+  let cursor = 1;
+  while (cursor < tokens.length && DECLARATION_KEYWORDS.includes(tokens[cursor])) {
+    cursor += 1;
+  }
+  if (cursor >= tokens.length) {
+    return void 0;
+  }
+  const candidate = tokens[cursor];
+  if (candidate.startsWith("{")) {
+    const stripped = candidate.replace(/^\{/, "").replace(/[},].*$/, "");
+    return stripped || void 0;
+  }
+  const cleaned = candidate.replace(/[<(:;].*$/, "");
+  return cleaned || void 0;
+}
+function extractExportListNames(declaration) {
+  const open = declaration.indexOf("{");
+  const close = declaration.indexOf("}", open);
+  if (open < 0 || close < 0) {
+    return [];
+  }
+  const inside = declaration.slice(open + 1, close);
+  const names = [];
+  for (const part of inside.split(",")) {
+    const token = part.trim();
+    if (!token) {
+      continue;
+    }
+    const asMatch = token.match(/\sas\s+(\S+)$/);
+    if (asMatch) {
+      names.push(asMatch[1]);
+    } else {
+      names.push(token);
+    }
+  }
+  return names;
+}
+
+// src/docs-sync/scan/checks/reference-mismatch-check.ts
+function referenceRecordToFinding(record, signatureChangedSymbols) {
+  if (signatureChangedSymbols.has(record.symbol)) {
+    return {
+      category: AuditCategory.ReferenceMismatches,
+      severity: AuditSeverity.Advisory,
+      location: { file: record.docPath, line: record.line },
+      subject: record.symbol,
+      details: `Inline reference \`${record.symbol}\` resolves to a symbol whose signature has changed; review the surrounding prose.`,
+      mismatch: "signature-changed",
+      symbol: record.symbol
+    };
+  }
+  if (!record.isKnown) {
+    return {
+      category: AuditCategory.ReferenceMismatches,
+      severity: AuditSeverity.Advisory,
+      location: { file: record.docPath, line: record.line },
+      subject: record.symbol,
+      details: `Inline reference \`${record.symbol}\` does not match any known public export.`,
+      mismatch: "unknown-symbol",
+      symbol: record.symbol
+    };
+  }
+  return void 0;
+}
+function createReferenceMismatchCheck(options) {
+  const records = options.records;
+  const signatureChangedSymbols = new Set(
+    options.signatureChangedSymbols ?? []
+  );
+  return {
+    name: options.name ?? "referenceMismatches",
+    run(_context) {
+      const findings = [];
+      for (const record of records) {
+        const finding = referenceRecordToFinding(
+          record,
+          signatureChangedSymbols
+        );
+        if (finding !== void 0) {
+          findings.push(finding);
+        }
+      }
+      return findings;
+    }
+  };
+}
+
+// src/docs-sync/scan/checks/tsdoc-coverage-check.ts
+var path5 = __toESM(require("path"));
+function tsdocRecordToFindings(record, context) {
+  const findings = [];
+  const file = relativizeFile(record.location.file, context.repoRoot);
+  const line = record.location.line;
+  const symbol = record.symbol;
+  if (!record.hasSummary) {
+    findings.push({
+      category: AuditCategory.TsdocCoverage,
+      severity: AuditSeverity.Mechanical,
+      location: { file, line },
+      subject: symbol,
+      details: `Public export \`${symbol}\` is missing a TSDoc summary.`,
+      shortfall: "missing-summary",
+      symbol,
+      fixHint: "stub-tsdoc"
+    });
+    return findings;
+  }
+  if (record.hasThinSummary) {
+    findings.push({
+      category: AuditCategory.TsdocCoverage,
+      severity: AuditSeverity.Advisory,
+      location: { file, line },
+      subject: symbol,
+      details: `Public export \`${symbol}\` carries a thin TSDoc summary; consider expanding it.`,
+      shortfall: "thin-summary",
+      symbol
+    });
+  }
+  if (!record.hasParams && isParamCarryingKind(record)) {
+    findings.push({
+      category: AuditCategory.TsdocCoverage,
+      severity: AuditSeverity.Advisory,
+      location: { file, line },
+      subject: symbol,
+      details: `Public export \`${symbol}\` has parameters with no \`@param\` block tag.`,
+      shortfall: "missing-params",
+      symbol
+    });
+  }
+  if (!record.hasReturns && isReturnCarryingKind(record)) {
+    findings.push({
+      category: AuditCategory.TsdocCoverage,
+      severity: AuditSeverity.Advisory,
+      location: { file, line },
+      subject: symbol,
+      details: `Public export \`${symbol}\` has a return value with no \`@returns\` block tag.`,
+      shortfall: "missing-returns",
+      symbol
+    });
+  }
+  return findings;
+}
+function createTsdocCoverageCheck(options) {
+  const records = options.records;
+  return {
+    name: options.name ?? "tsdocCoverage",
+    run(context) {
+      const findings = [];
+      for (const record of records) {
+        for (const finding of tsdocRecordToFindings(record, context)) {
+          findings.push(finding);
+        }
+      }
+      return findings;
+    }
+  };
+}
+function isParamCarryingKind(record) {
+  return record.kind === "Function";
+}
+function isReturnCarryingKind(record) {
+  return record.kind === "Function";
+}
+function relativizeFile(file, repoRoot) {
+  if (!file) {
+    return "";
+  }
+  if (!path5.isAbsolute(file)) {
+    return toPosix3(file);
+  }
+  const rel = path5.relative(repoRoot, file);
+  return toPosix3(rel);
+}
+function toPosix3(p) {
+  return p.split(path5.sep).join("/");
+}
+
 // src/docs-sync/scan/run-scan.ts
 var fs3 = __toESM(require("fs"));
-var path5 = __toESM(require("path"));
+var path6 = __toESM(require("path"));
 var DEFAULT_AUDIT_REPORT_DIR = ".claude/state/docs-sync";
 var SEVERITY_RANK = {
   blocking: 0,
@@ -29965,7 +29816,7 @@ var AUDIT_CATEGORY_ORDER = [
   AuditCategory.SampleFailures
 ];
 function runScan(options) {
-  const repoRoot = path5.resolve(options.repoRoot);
+  const repoRoot = path6.resolve(options.repoRoot);
   const mode = options.mode;
   const scope = options.scope ?? "";
   const issueNumber = options.issueNumber;
@@ -30040,11 +29891,11 @@ function buildReport(args) {
   };
 }
 function persistAuditReport(args) {
-  const repoRoot = path5.resolve(args.repoRoot);
+  const repoRoot = path6.resolve(args.repoRoot);
   const reportDir = args.reportDir ?? DEFAULT_AUDIT_REPORT_DIR;
-  const targetDir = path5.resolve(repoRoot, reportDir);
+  const targetDir = path6.resolve(repoRoot, reportDir);
   fs3.mkdirSync(targetDir, { recursive: true });
-  const targetFile = path5.join(
+  const targetFile = path6.join(
     targetDir,
     `${args.report.issueNumber}-audit.json`
   );
@@ -30107,7 +29958,7 @@ function compareFindings(a, b) {
 }
 
 // src/docs-sync/tsdoc-coverage/coverage.ts
-var path6 = __toESM(require("path"));
+var path7 = __toESM(require("path"));
 var import_tsdoc = require("@microsoft/tsdoc");
 var ts2 = __toESM(require("typescript"));
 var TsDocCoverageKind = {
@@ -30125,8 +29976,8 @@ var DEFAULT_THIN_SUMMARY_WORD_THRESHOLD = 4;
 var DEFAULT_ENTRY_POINT = "src/index.ts";
 function analyzeTsDocCoverage(options) {
   const resolvedOptions = typeof options === "string" ? { packageRoot: options } : options;
-  const packageRoot = path6.resolve(resolvedOptions.packageRoot);
-  const entryPoint = path6.resolve(
+  const packageRoot = path7.resolve(resolvedOptions.packageRoot);
+  const entryPoint = path7.resolve(
     packageRoot,
     resolvedOptions.entryPoint ?? DEFAULT_ENTRY_POINT
   );
@@ -30189,7 +30040,7 @@ function analyzeTsDocCoverage(options) {
 }
 function resolveCompilerOptions(packageRoot, tsconfigPath) {
   if (tsconfigPath) {
-    const absoluteTsconfig = path6.resolve(packageRoot, tsconfigPath);
+    const absoluteTsconfig = path7.resolve(packageRoot, tsconfigPath);
     const configFile = ts2.readConfigFile(absoluteTsconfig, ts2.sys.readFile);
     if (configFile.error) {
       throw new Error(
@@ -30199,7 +30050,7 @@ function resolveCompilerOptions(packageRoot, tsconfigPath) {
     const parsed = ts2.parseJsonConfigFileContent(
       configFile.config,
       ts2.sys,
-      path6.dirname(absoluteTsconfig)
+      path7.dirname(absoluteTsconfig)
     );
     return { ...parsed.options, noEmit: true };
   }
@@ -30508,14 +30359,14 @@ var LAYOUT_ROOT_BY_PROJECT_TYPE = {
 };
 function validateMonorepoLayout(root) {
   const violations = [];
-  const rootOutdir = toPosix3(root.outdir);
+  const rootOutdir = toPosix4(root.outdir);
   for (const sub of root.subprojects) {
     const className = sub.constructor.name;
     const expectedRoot = expectedRootFor(sub, className);
     if (expectedRoot === void 0) {
       continue;
     }
-    const relOutdir = relativeOutdir(rootOutdir, toPosix3(sub.outdir));
+    const relOutdir = relativeOutdir(rootOutdir, toPosix4(sub.outdir));
     if (!outdirMatchesRoot(relOutdir, expectedRoot)) {
       violations.push({
         projectName: sub.name,
@@ -30574,7 +30425,7 @@ function outdirMatchesRoot(relOutdir, expectedRoot) {
   }
   return segments.length >= 2;
 }
-function toPosix3(p) {
+function toPosix4(p) {
   return p.replace(/\\/g, "/");
 }
 function relativeOutdir(rootOutdir, subOutdir) {
@@ -30654,8 +30505,8 @@ var ResetTask = class _ResetTask extends import_projen14.Component {
     const resetTask = this.project.tasks.addTask(this.taskName, {
       description: "Delete build artifacts specified by pathsToRemove option, or artifactsDirectory if pathsToRemove is empty"
     });
-    this.pathsToRemove.forEach((path7) => {
-      resetTask.exec(`[ -e "${path7}" ] && rm -rf ${path7} || true`);
+    this.pathsToRemove.forEach((path8) => {
+      resetTask.exec(`[ -e "${path8}" ] && rm -rf ${path8} || true`);
     });
     const rootHasTurbo = TurboRepo.of(this.project.root) !== void 0;
     const isSubproject = this.project !== this.project.root;
@@ -30997,6 +30848,7 @@ var DEFAULT_TYPE_LABELS = [
 ];
 var DEFAULT_WORKFLOW_NAME2 = "sync-labels";
 var LABELS_CONFIG_PATH = ".github/labels.yml";
+var MAX_LABEL_DESCRIPTION_LENGTH = 100;
 function addSyncLabelsWorkflow(project, options) {
   const workflowName = options.workflowName ?? DEFAULT_WORKFLOW_NAME2;
   const deleteOtherLabels = options.deleteOtherLabels ?? true;
@@ -31019,6 +30871,18 @@ function addSyncLabelsWorkflow(project, options) {
     labelMap.set(label.name, label);
   }
   const allLabels = [...labelMap.values()];
+  const overlength = allLabels.filter(
+    (l) => (l.description ?? "").length > MAX_LABEL_DESCRIPTION_LENGTH
+  );
+  if (overlength.length > 0) {
+    const offenders = overlength.map(
+      (l) => `  - ${l.name} (${(l.description ?? "").length} chars): ${l.description}`
+    ).join("\n");
+    throw new Error(
+      `The following label descriptions exceed GitHub's ${MAX_LABEL_DESCRIPTION_LENGTH}-char limit and would break the sync-labels workflow:
+${offenders}`
+    );
+  }
   new LabelsFile(project, allLabels);
   const workflow = project.github?.addWorkflow(workflowName);
   if (!workflow) {
@@ -32660,16 +32524,11 @@ var TypeScriptConfig = class extends import_projen23.Component {
   DEFAULT_TYPE_LABELS,
   DEFAULT_UNBLOCK_COMMENT_TEMPLATE,
   DEFAULT_UNBLOCK_DEPENDENTS_ENABLED,
-  DEFAULT_WORKFLOW_DIAGRAMS_BUNDLE_PATH_PATTERNS,
-  DEFAULT_WORKFLOW_DIAGRAMS_EMIT_CHECKER,
-  DEFAULT_WORKFLOW_DIAGRAMS_EMIT_STARTER,
-  DEFAULT_WORKFLOW_DIAGRAMS_ENABLED,
-  DEFAULT_WORKFLOW_DIAGRAMS_PATH,
-  DEFAULT_WORKFLOW_DIAGRAMS_REQUIRE_UPDATE,
   DOCS_SYNC_AUDIT_SCHEMA_VERSION,
   JsiiFaker,
   LAYOUT_ENFORCEMENT,
   LAYOUT_ROOT_BY_PROJECT_TYPE,
+  MAX_LABEL_DESCRIPTION_LENGTH,
   MCP_TRANSPORT,
   MERGE_METHODS,
   MIMIMUM_RELEASE_AGE,
@@ -32740,7 +32599,11 @@ var TypeScriptConfig = class extends import_projen23.Component {
   classifyRun,
   companyProfileBundle,
   compileFencedSamples,
+  createApiDiffCheck,
+  createReferenceMismatchCheck,
+  createTsdocCoverageCheck,
   customerProfileBundle,
+  diffApiRollups,
   docsSyncBundle,
   emptyCategoryBuckets,
   extractApiProcedure,
@@ -32755,11 +32618,13 @@ var TypeScriptConfig = class extends import_projen23.Component {
   maintenanceAuditBundle,
   meetingAnalysisBundle,
   orchestratorBundle,
+  parseApiRollup,
   peopleProfileBundle,
   persistAuditReport,
   pnpmBundle,
   prReviewBundle,
   projenBundle,
+  referenceRecordToFinding,
   regulatoryResearchBundle,
   renderAgentTierCaseStatement,
   renderAgentTierSection,
@@ -32796,10 +32661,6 @@ var TypeScriptConfig = class extends import_projen23.Component {
   renderSourceTierExamples,
   renderUnblockDependentsScript,
   renderUnblockDependentsSection,
-  renderWorkflowDiagramsBundleHook,
-  renderWorkflowDiagramsCheckerScript,
-  renderWorkflowDiagramsRuleContent,
-  renderWorkflowDiagramsStarterPage,
   requirementsAnalystBundle,
   requirementsReviewerBundle,
   requirementsWriterBundle,
@@ -32822,11 +32683,11 @@ var TypeScriptConfig = class extends import_projen23.Component {
   resolveTemplateVariables,
   resolveTypeScriptProjectOutdir,
   resolveUnblockDependents,
-  resolveWorkflowDiagrams,
   runScan,
   slackBundle,
   softwareProfileBundle,
   standardsResearchBundle,
+  tsdocRecordToFindings,
   turborepoBundle,
   typescriptBundle,
   validateAgentTierConfig,
@@ -32841,7 +32702,6 @@ var TypeScriptConfig = class extends import_projen23.Component {
   validateSkillEvalsConfig,
   validateStarlightSingleton,
   validateUnblockDependentsConfig,
-  validateWorkflowDiagramsConfig,
   vitestBundle
 });
 //# sourceMappingURL=index.js.map