@codedrifters/configulator 0.0.257 → 0.0.258

package/lib/index.mjs

@@ -1295,6 +1295,98 @@ var baseBundle = {
       ].join("\n"),
       tags: ["project"]
     },
+    {
+      name: "source-quality-verification",
+      description: "Source tier hierarchy (T1\u2013T4), conflict resolution, temporal validity, and source-annotation format for research-producing agents",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Source Quality & Verification",
+        "",
+        "All research-producing agents must follow this source hierarchy when",
+        "writing profiles and reference documents. The tiers govern which",
+        "source to prefer when claims conflict and when time-sensitive claims",
+        "need re-verification.",
+        "",
+        "## Source Tier Hierarchy",
+        "",
+        "### T1 \u2014 Primary Living",
+        "",
+        "Authoritative sources that update when reality changes.",
+        "Use these for current-state claims. Examples:",
+        "",
+        "- Official product docs and API references",
+        "- Company about / leadership / team pages",
+        "- Live government registries (SEC EDGAR, Companies House)",
+        "- Current-role LinkedIn profiles",
+        "- Investor relations pages",
+        "",
+        "### T2 \u2014 Primary Snapshot",
+        "",
+        "Authoritative but time-stamped sources straight from the subject.",
+        "Trust for current state only when fresh (< 6 months) and no T1",
+        "source contradicts them. Examples:",
+        "",
+        "- Press releases from the entity",
+        "- Earnings transcripts and investor calls",
+        "- Regulatory filings (10-K, 10-Q, 8-K)",
+        "- Official announcements and conference presentations",
+        "",
+        "### T3 \u2014 Secondary",
+        "",
+        "Third-party sources that interpret or re-report primary material.",
+        "Good for context and triangulation; T1 wins on conflict. Examples:",
+        "",
+        "- News articles and trade press",
+        "- Industry reports and analyst research",
+        "- Database aggregators (Crunchbase, PitchBook, Owler)",
+        "",
+        "### T4 \u2014 Self-Reported / Marketing",
+        "",
+        "Promotional or unverified sources. Use for discovery and leads only",
+        "\u2014 never as the sole source for a factual claim, and always note the",
+        "self-reported nature in the annotation. Examples:",
+        "",
+        "- Vendor comparison pages and customer testimonials on vendor sites",
+        "- Social-media posts",
+        "- Job postings",
+        "- Wikipedia",
+        "",
+        "## Conflict Resolution",
+        "",
+        "Higher tier wins. Within the same tier, more recent wins. If a newer",
+        "T2 source contradicts an older T1 source on a time-sensitive claim,",
+        "flag for re-verification \u2014 the T1 source may simply not have been",
+        "updated yet.",
+        "",
+        "## Temporal Validity",
+        "",
+        "Some claims decay faster than others. When a fast-decay claim comes",
+        "from a source older than 6 months, agents **must** attempt to",
+        "corroborate it with a T1 living source. If no T1 source is available,",
+        "add an inline note: `_(source: YYYY-MM, may need re-verification)_`.",
+        "",
+        "| Decay | Re-verify if source older than | Typical claims |",
+        "|-------|-------------------------------|----------------|",
+        "| **Fast** | 6 months | Leadership roles, employee count, pricing, product features, funding status, office locations |",
+        "| **Slow** | 18 months | Founding year, ownership structure, core business description, industry classification, HQ location |",
+        "| **Stable** | Verify once, note source date | Historical facts (acquisition dates, founding story), published financials for a specific period |",
+        "",
+        "## Source Annotation Format",
+        "",
+        "In the `## Sources` section of profiles and reference documents,",
+        "annotate each source with its tier and date:",
+        "",
+        "```",
+        "1. [Company Leadership Page](https://...) \u2014 T1, accessed 2026-04",
+        "2. [Company press release](https://...) \u2014 T2, published 2026-02",
+        "3. [TechCrunch coverage](https://...) \u2014 T3, published 2025-11",
+        "```",
+        "",
+        "Use `accessed YYYY-MM` for living sources (T1) and `published YYYY-MM`",
+        "for snapshot sources (T2, T3, T4)."
+      ].join("\n"),
+      tags: ["workflow"]
+    },
     {
       name: "issue-conventions",
       description: "Issue title prefixes, GitHub issue type mapping, prerequisite issues",
@@ -14488,6 +14580,141 @@ var vitestBundle = {
   }
 };
 
+// src/agent/bundles/features.ts
+var SOURCE_TIER_HEADINGS = [
+  { key: "t1", heading: "### T1 \u2014 Primary Living" },
+  { key: "t2", heading: "### T2 \u2014 Primary Snapshot" },
+  { key: "t3", heading: "### T3 \u2014 Secondary" },
+  { key: "t4", heading: "### T4 \u2014 Self-Reported / Marketing" }
+];
+function renderSourceTierExamples(content, examples) {
+  if (!examples) {
+    return content;
+  }
+  const tierEntries = SOURCE_TIER_HEADINGS.flatMap(({ key, heading }) => {
+    const list = examples[key];
+    if (!list || list.length === 0) {
+      return [];
+    }
+    return [{ heading, list }];
+  });
+  if (tierEntries.length === 0) {
+    return content;
+  }
+  let updated = content;
+  for (const { heading, list } of tierEntries) {
+    const injection = [
+      "",
+      "**Project-specific examples:**",
+      "",
+      ...list.map((ex) => `- ${ex}`)
+    ].join("\n");
+    updated = insertAfterHeadingBlock(updated, heading, injection);
+  }
+  return updated;
+}
+function renderCustomDocSections(bundle, sections) {
+  const matching = sections.filter((s) => s.bundleName === bundle.name);
+  if (matching.length === 0) {
+    return bundle;
+  }
+  let rules = bundle.rules;
+  const currentAnchorByTarget = /* @__PURE__ */ new Map();
+  for (const section of matching) {
+    const injection = renderCustomDocSectionBlock(section);
+    const seededAnchor = currentAnchorByTarget.get(section.afterSection);
+    let targetIndex = -1;
+    let targetHeading = "";
+    for (let i = 0; i < rules.length; i += 1) {
+      if (seededAnchor && rules[i].content.includes(seededAnchor)) {
+        targetIndex = i;
+        targetHeading = seededAnchor;
+        break;
+      }
+      if (!seededAnchor) {
+        const match = findHeadingForTitle(
+          rules[i].content,
+          section.afterSection
+        );
+        if (match) {
+          targetIndex = i;
+          targetHeading = match;
+          break;
+        }
+      }
+    }
+    if (targetIndex === -1) {
+      continue;
+    }
+    const targetRule = rules[targetIndex];
+    const updatedRule = {
+      ...targetRule,
+      content: insertAfterHeadingBlock(
+        targetRule.content,
+        targetHeading,
+        injection
+      )
+    };
+    rules = [
+      ...rules.slice(0, targetIndex),
+      updatedRule,
+      ...rules.slice(targetIndex + 1)
+    ];
+    currentAnchorByTarget.set(
+      section.afterSection,
+      `## ${section.sectionTitle}`
+    );
+  }
+  if (rules === bundle.rules) {
+    return bundle;
+  }
+  return { ...bundle, rules };
+}
+function renderCustomDocSectionBlock(section) {
+  const body = section.body.replace(/[\r\n]+$/u, "");
+  return ["", `## ${section.sectionTitle}`, "", body].join("\n");
+}
+function findHeadingForTitle(content, title) {
+  const lines = content.split("\n");
+  for (const line of lines) {
+    const match = line.match(/^(#{1,6}) (.+)$/u);
+    if (match && match[2] === title) {
+      return line;
+    }
+  }
+  return void 0;
+}
+function insertAfterHeadingBlock(content, heading, injection) {
+  const lines = content.split("\n");
+  const headingIndex = lines.findIndex((line) => line === heading);
+  if (headingIndex === -1) {
+    return content;
+  }
+  const headingLevel = countLeadingHashes(heading);
+  let endIndex = lines.length - 1;
+  for (let i = headingIndex + 1; i < lines.length; i += 1) {
+    const nextLevel = countLeadingHashes(lines[i]);
+    if (nextLevel > 0 && nextLevel <= headingLevel) {
+      endIndex = i - 1;
+      break;
+    }
+  }
+  while (endIndex > headingIndex && lines[endIndex] === "") {
+    endIndex -= 1;
+  }
+  const injectionLines = injection.split("\n");
+  const next = [
+    ...lines.slice(0, endIndex + 1),
+    ...injectionLines,
+    ...lines.slice(endIndex + 1)
+  ];
+  return next.join("\n");
+}
+function countLeadingHashes(line) {
+  const match = line.match(/^(#{1,6}) /u);
+  return match ? match[1].length : 0;
+}
+
 // src/agent/bundles/focus.ts
 var DEFAULT_FOCUS_FILE_PATH = ".claude/focus.json";
 var DEFAULT_SCHEMA_VERSION = 1;
@@ -15458,6 +15685,19 @@ var AgentConfig = class _AgentConfig extends Component8 {
     const isAgentConfig = (c) => c instanceof _AgentConfig;
     return project.components.find(isAgentConfig);
   }
+  /**
+   * Returns `true` when at least one tier array on the supplied
+   * `SourceTierExamples` is non-empty, signalling that the consuming
+   * repo has opted into rendering the base bundle's
+   * `source-quality-verification` rule. Returns `false` for
+   * `undefined`, `{}`, or a fully-empty `{ t1: [], t2: [], t3: [], t4: [] }`.
+   */
+  static hasActiveTierExamples(examples) {
+    if (!examples) {
+      return false;
+    }
+    return (examples.t1?.length ?? 0) > 0 || (examples.t2?.length ?? 0) > 0 || (examples.t3?.length ?? 0) > 0 || (examples.t4?.length ?? 0) > 0;
+  }
   /**
    * Merges default Claude permissions with bundle and user-supplied settings.
    *
@@ -15677,6 +15917,24 @@ ${section}`
         }
       }
     }
+    const tierExamples = this.options.features?.sourceTierExamples;
+    if (_AgentConfig.hasActiveTierExamples(tierExamples)) {
+      const sourceRule = ruleMap.get("source-quality-verification");
+      if (sourceRule) {
+        const updated = renderSourceTierExamples(
+          sourceRule.content,
+          tierExamples
+        );
+        if (updated !== sourceRule.content) {
+          ruleMap.set("source-quality-verification", {
+            ...sourceRule,
+            content: updated
+          });
+        }
+      }
+    } else {
+      ruleMap.delete("source-quality-verification");
+    }
     return [...ruleMap.values()].sort((a, b) => {
       if (a.name === "project-overview") return -1;
       if (b.name === "project-overview") return 1;
@@ -15689,19 +15947,24 @@ ${section}`
   /**
    * Return a bundle's rules with `filePatterns` narrowed to the projects
    * that actually matched the bundle's detection predicate (when the bundle
-   * provides `findApplicableProjects`). Rules with `ALWAYS` scope and rules
-   * on bundles that don't implement the hook are returned unchanged.
+   * provides `findApplicableProjects`) and any project-specified
+   * `features.customDocSections` entries injected into the matching rule
+   * content. Rules with `ALWAYS` scope and rules on bundles that don't
+   * implement the hook are returned with only the custom-section
+   * transformation (if any) applied.
    */
   bundleRulesFor(bundle) {
-    if (!bundle.findApplicableProjects) {
-      return bundle.rules;
+    const customSections = this.options.features?.customDocSections ?? [];
+    const withCustomSections = customSections.length > 0 ? renderCustomDocSections(bundle, customSections) : bundle;
+    if (!withCustomSections.findApplicableProjects) {
+      return withCustomSections.rules;
     }
-    const detected = bundle.findApplicableProjects(this.project);
+    const detected = withCustomSections.findApplicableProjects(this.project);
     if (detected.length === 0) {
-      return bundle.rules;
+      return withCustomSections.rules;
     }
     const scoped = scopeFilePatternsToProjects(this.project, detected);
-    return bundle.rules.map(
+    return withCustomSections.rules.map(
       (rule) => rule.scope === AGENT_RULE_SCOPE.FILE_PATTERN ? { ...rule, filePatterns: scoped } : rule
     );
   }
@@ -18500,9 +18763,12 @@ export {
   pnpmBundle,
   prReviewBundle,
   projenBundle,
+  renderCustomDocSectionBlock,
+  renderCustomDocSections,
   renderFocusSection,
   renderMeetingTypesSection,
   renderPriorityRulesSection,
+  renderSourceTierExamples,
   requirementsAnalystBundle,
   requirementsReviewerBundle,
   requirementsWriterBundle,