@codedrifters/configulator 0.0.292 → 0.0.294

package/lib/index.d.mts

@@ -1684,7 +1684,11 @@ interface ScopeGateConfig {
      * phase-completion checklist that can be decomposed — clear the
      * gate even when their AC count is well above the global cap.
      *
-     * Configulator ships two opt-in defaults out of the box:
+     * Configulator ships eight opt-in defaults out of the box —
+     * each calibrated against an observed cohort of phase-template
+     * issues whose AC list is the per-section content checklist for
+     * one cohesive deliverable rather than a phase-completion
+     * checklist that can be decomposed:
      *
      * - `req:write` — formal requirement documents (ADR / TR / OPS /
      *   SEC / NFR / UX / MT) routinely carry 12–20 ACs covering
@@ -1694,6 +1698,30 @@ interface ScopeGateConfig {
      *   addendum requirements into coarse ACs but still land above
      *   the global cap. Default override:
      *   `{ acceptanceCriteria: { mediumMax: 12 } }` (sources unchanged).
+     * - `research:verify` — fixed-shape verify template emitted by
+     *   the `research-analyst` slice phase (uniformly `ac=9 / src=2`
+     *   in the wild). Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 12 } }` (sources unchanged).
+     * - `software:profile` — single software-product profile pages
+     *   with per-section content invariants. Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 14 } }` (sources unchanged).
+     * - `regulatory:research` — single regulation pages covering
+     *   jurisdiction, scope, obligations, penalties, and effective
+     *   dates. Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 10 } }` (sources unchanged).
+     * - `software:map` — single capability-mapping matrix file whose
+     *   Sources block typically cross-references the entire BCM tree
+     *   slice. Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 12 }, sources: { mediumMax: 15 } }`.
+     * - `bcm:connect` — connect-phase outputs that cross-link a
+     *   capability to upstream value streams, downstream profiles,
+     *   and adjacent capabilities. Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 12 }, sources: { mediumMax: 8 } }`.
+     * - `software:matrix` — physician-RCM-style feature matrices
+     *   (per-row/per-column requirements for one cohesive matrix
+     *   file). Mirrors `software:map` (closest peer). Default
+     *   override:
+     *   `{ acceptanceCriteria: { mediumMax: 12 }, sources: { mediumMax: 15 } }`.
      *
      * Consumer overrides **deep-merge** with the shipped defaults
      * with **consumer-wins-per-key**:
@@ -3422,7 +3450,7 @@ declare const baseBundle: AgentRuleBundle;
  * surfaced items via `people:research`, `company:research`, and
  * `research:scope` issues.
  */
-declare function buildBcmWriterBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildBcmWriterBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the bcm-writer bundle, preserved for
  * backward compatibility with consumers that import the const directly.
@@ -3446,7 +3474,7 @@ declare const bcmWriterBundle: AgentRuleBundle;
  * `company-profile` via the shared `<BUSINESS_MODELS_ROOT>` default
  * path (`<docsRoot>/industry-research/`).
  */
-declare function buildBusinessModelsBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildBusinessModelsBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the business-models bundle, preserved for
  * backward compatibility with consumers that import the const
@@ -3672,7 +3700,7 @@ declare const jestBundle: AgentRuleBundle;
  * automatically pick up the label taxonomy through the sync-labels
  * workflow.
  */
-declare function buildMaintenanceAuditBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildMaintenanceAuditBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the maintenance-audit bundle, preserved
  * for backward compatibility with consumers that import the const
@@ -4016,7 +4044,7 @@ declare const DEFAULT_SOURCES_THRESHOLDS: ScopeGateThresholds;
  * calibrated for phased-bundle issues and systematically over-flags
  * single-document writes.
  *
- * The two shipped overrides:
+ * The shipped overrides:
  *
  * - `req:write` — formal requirement documents (ADR / TR / OPS /
  *   SEC / NFR / UX / MT) routinely carry 12–20 ACs covering
@@ -4027,6 +4055,41 @@ declare const DEFAULT_SOURCES_THRESHOLDS: ScopeGateThresholds;
  *   addendum requirements into coarse ACs but still land above
  *   the global cap. Cap: `mediumMax: 12` on the AC axis; sources
  *   unchanged.
+ * - `research:verify` — the `research-analyst` slice phase emits
+ *   a fixed-shape verify template. A 32-issue cohort observed in
+ *   `codedrifters/openhi-planning` (2026-05-04) all landed at
+ *   identical `ac=9 / src=2` dimensions, so the template's shape
+ *   itself is what trips the global cap. Cap: `mediumMax: 12` on
+ *   the AC axis (max observed 9 + ~3 headroom); sources unchanged.
+ * - `software:profile` — software-product profile pages enumerate
+ *   per-section content invariants (overview, vendor, integrations,
+ *   pricing, security posture, …). Max observed 11 ACs in the same
+ *   openhi-planning sample; cap: `mediumMax: 14` on the AC axis
+ *   (max observed + 3 headroom); sources unchanged.
+ * - `regulatory:research` — single regulation pages carry per-
+ *   section ACs covering jurisdiction, scope, obligations,
+ *   penalties, and effective dates. Max observed 7 ACs; cap:
+ *   `mediumMax: 10` on the AC axis (max observed + 3 headroom);
+ *   sources unchanged.
+ * - `software:map` — capability-mapping output is a single cohesive
+ *   matrix file whose ACs enumerate per-row/per-column requirements
+ *   and whose Sources block typically cross-references the entire
+ *   BCM tree slice. Max observed `ac=9 / src=13`; cap:
+ *   `acceptanceCriteria.mediumMax: 12` (max + 3) and
+ *   `sources.mediumMax: 15` (max + 2 — sources headroom is tighter
+ *   because BCM cross-refs naturally cap out near the slice size).
+ * - `bcm:connect` — connect-phase outputs cross-link a capability
+ *   to upstream value streams, downstream profiles, and adjacent
+ *   capabilities. Max observed `ac=9 / src=6`; cap:
+ *   `acceptanceCriteria.mediumMax: 12` (max + 3) and
+ *   `sources.mediumMax: 8` (max + 2).
+ * - `software:matrix` — physician-RCM-style feature matrices
+ *   (per-row/per-column requirements for one cohesive matrix
+ *   file). The shape mirrors `software:map`: single-cohesive-
+ *   file matrix output whose ACs enumerate per-row/per-column
+ *   requirements rather than phase milestones. Mirrors the
+ *   `software:map` thresholds verbatim (closest-peer rationale,
+ *   surfaced by openhi-planning#3223).
  *
  * Consumer overrides deep-merge with these defaults with
  * consumer-wins-per-key (see `resolveScopeGate` for the merge
@@ -5277,7 +5340,7 @@ declare function renderStubIndexConventionRuleContent(): string;
  * consumer override of `AgentConfigOptions.paths` propagates to the
  * rendered output.
  */
-declare function buildRequirementsAnalystBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildRequirementsAnalystBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the requirements-analyst bundle, preserved
  * for backward compatibility with consumers that import the const
@@ -5317,7 +5380,7 @@ declare const requirementsAnalystBundle: AgentRuleBundle;
  * phase label so they share the same queue and triage flow as the
  * rest of the requirements pipeline.
  */
-declare function buildRequirementsReviewerBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildRequirementsReviewerBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the requirements-reviewer bundle, preserved
  * for backward compatibility with consumers that import the const
@@ -5360,7 +5423,7 @@ declare const REQUIREMENTS_WRITER_PATHS: {
  * `type:requirement` is intentionally **not** declared here — it is
  * already declared by the `requirements-analyst` bundle and reused.
  */
-declare function buildRequirementsWriterBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildRequirementsWriterBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the requirements-writer bundle, preserved
  * for backward compatibility with consumers that import the const
@@ -5377,7 +5440,7 @@ declare const requirementsWriterBundle: AgentRuleBundle;
  * interpolation of the supplied `paths` struct, so a consumer override
  * of `AgentConfigOptions.paths` propagates to the rendered output.
  */
-declare function buildResearchPipelineBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildResearchPipelineBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the research-pipeline bundle, preserved
  * for backward compatibility with consumers that import the const

package/lib/index.d.ts

@@ -1733,7 +1733,11 @@ interface ScopeGateConfig {
      * phase-completion checklist that can be decomposed — clear the
      * gate even when their AC count is well above the global cap.
      *
-     * Configulator ships two opt-in defaults out of the box:
+     * Configulator ships eight opt-in defaults out of the box —
+     * each calibrated against an observed cohort of phase-template
+     * issues whose AC list is the per-section content checklist for
+     * one cohesive deliverable rather than a phase-completion
+     * checklist that can be decomposed:
      *
      * - `req:write` — formal requirement documents (ADR / TR / OPS /
      *   SEC / NFR / UX / MT) routinely carry 12–20 ACs covering
@@ -1743,6 +1747,30 @@ interface ScopeGateConfig {
      *   addendum requirements into coarse ACs but still land above
      *   the global cap. Default override:
      *   `{ acceptanceCriteria: { mediumMax: 12 } }` (sources unchanged).
+     * - `research:verify` — fixed-shape verify template emitted by
+     *   the `research-analyst` slice phase (uniformly `ac=9 / src=2`
+     *   in the wild). Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 12 } }` (sources unchanged).
+     * - `software:profile` — single software-product profile pages
+     *   with per-section content invariants. Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 14 } }` (sources unchanged).
+     * - `regulatory:research` — single regulation pages covering
+     *   jurisdiction, scope, obligations, penalties, and effective
+     *   dates. Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 10 } }` (sources unchanged).
+     * - `software:map` — single capability-mapping matrix file whose
+     *   Sources block typically cross-references the entire BCM tree
+     *   slice. Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 12 }, sources: { mediumMax: 15 } }`.
+     * - `bcm:connect` — connect-phase outputs that cross-link a
+     *   capability to upstream value streams, downstream profiles,
+     *   and adjacent capabilities. Default override:
+     *   `{ acceptanceCriteria: { mediumMax: 12 }, sources: { mediumMax: 8 } }`.
+     * - `software:matrix` — physician-RCM-style feature matrices
+     *   (per-row/per-column requirements for one cohesive matrix
+     *   file). Mirrors `software:map` (closest peer). Default
+     *   override:
+     *   `{ acceptanceCriteria: { mediumMax: 12 }, sources: { mediumMax: 15 } }`.
      *
      * Consumer overrides **deep-merge** with the shipped defaults
      * with **consumer-wins-per-key**:
@@ -3471,7 +3499,7 @@ declare const baseBundle: AgentRuleBundle;
  * surfaced items via `people:research`, `company:research`, and
  * `research:scope` issues.
  */
-declare function buildBcmWriterBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildBcmWriterBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the bcm-writer bundle, preserved for
  * backward compatibility with consumers that import the const directly.
@@ -3495,7 +3523,7 @@ declare const bcmWriterBundle: AgentRuleBundle;
  * `company-profile` via the shared `<BUSINESS_MODELS_ROOT>` default
  * path (`<docsRoot>/industry-research/`).
  */
-declare function buildBusinessModelsBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildBusinessModelsBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the business-models bundle, preserved for
  * backward compatibility with consumers that import the const
@@ -3721,7 +3749,7 @@ declare const jestBundle: AgentRuleBundle;
  * automatically pick up the label taxonomy through the sync-labels
  * workflow.
  */
-declare function buildMaintenanceAuditBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildMaintenanceAuditBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the maintenance-audit bundle, preserved
  * for backward compatibility with consumers that import the const
@@ -4065,7 +4093,7 @@ declare const DEFAULT_SOURCES_THRESHOLDS: ScopeGateThresholds;
  * calibrated for phased-bundle issues and systematically over-flags
  * single-document writes.
  *
- * The two shipped overrides:
+ * The shipped overrides:
  *
  * - `req:write` — formal requirement documents (ADR / TR / OPS /
  *   SEC / NFR / UX / MT) routinely carry 12–20 ACs covering
@@ -4076,6 +4104,41 @@ declare const DEFAULT_SOURCES_THRESHOLDS: ScopeGateThresholds;
  *   addendum requirements into coarse ACs but still land above
  *   the global cap. Cap: `mediumMax: 12` on the AC axis; sources
  *   unchanged.
+ * - `research:verify` — the `research-analyst` slice phase emits
+ *   a fixed-shape verify template. A 32-issue cohort observed in
+ *   `codedrifters/openhi-planning` (2026-05-04) all landed at
+ *   identical `ac=9 / src=2` dimensions, so the template's shape
+ *   itself is what trips the global cap. Cap: `mediumMax: 12` on
+ *   the AC axis (max observed 9 + ~3 headroom); sources unchanged.
+ * - `software:profile` — software-product profile pages enumerate
+ *   per-section content invariants (overview, vendor, integrations,
+ *   pricing, security posture, …). Max observed 11 ACs in the same
+ *   openhi-planning sample; cap: `mediumMax: 14` on the AC axis
+ *   (max observed + 3 headroom); sources unchanged.
+ * - `regulatory:research` — single regulation pages carry per-
+ *   section ACs covering jurisdiction, scope, obligations,
+ *   penalties, and effective dates. Max observed 7 ACs; cap:
+ *   `mediumMax: 10` on the AC axis (max observed + 3 headroom);
+ *   sources unchanged.
+ * - `software:map` — capability-mapping output is a single cohesive
+ *   matrix file whose ACs enumerate per-row/per-column requirements
+ *   and whose Sources block typically cross-references the entire
+ *   BCM tree slice. Max observed `ac=9 / src=13`; cap:
+ *   `acceptanceCriteria.mediumMax: 12` (max + 3) and
+ *   `sources.mediumMax: 15` (max + 2 — sources headroom is tighter
+ *   because BCM cross-refs naturally cap out near the slice size).
+ * - `bcm:connect` — connect-phase outputs cross-link a capability
+ *   to upstream value streams, downstream profiles, and adjacent
+ *   capabilities. Max observed `ac=9 / src=6`; cap:
+ *   `acceptanceCriteria.mediumMax: 12` (max + 3) and
+ *   `sources.mediumMax: 8` (max + 2).
+ * - `software:matrix` — physician-RCM-style feature matrices
+ *   (per-row/per-column requirements for one cohesive matrix
+ *   file). The shape mirrors `software:map`: single-cohesive-
+ *   file matrix output whose ACs enumerate per-row/per-column
+ *   requirements rather than phase milestones. Mirrors the
+ *   `software:map` thresholds verbatim (closest-peer rationale,
+ *   surfaced by openhi-planning#3223).
  *
  * Consumer overrides deep-merge with these defaults with
  * consumer-wins-per-key (see `resolveScopeGate` for the merge
@@ -5326,7 +5389,7 @@ declare function renderStubIndexConventionRuleContent(): string;
  * consumer override of `AgentConfigOptions.paths` propagates to the
  * rendered output.
  */
-declare function buildRequirementsAnalystBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildRequirementsAnalystBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the requirements-analyst bundle, preserved
  * for backward compatibility with consumers that import the const
@@ -5366,7 +5429,7 @@ declare const requirementsAnalystBundle: AgentRuleBundle;
  * phase label so they share the same queue and triage flow as the
  * rest of the requirements pipeline.
  */
-declare function buildRequirementsReviewerBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildRequirementsReviewerBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the requirements-reviewer bundle, preserved
  * for backward compatibility with consumers that import the const
@@ -5409,7 +5472,7 @@ declare const REQUIREMENTS_WRITER_PATHS: {
  * `type:requirement` is intentionally **not** declared here — it is
  * already declared by the `requirements-analyst` bundle and reused.
  */
-declare function buildRequirementsWriterBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildRequirementsWriterBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the requirements-writer bundle, preserved
  * for backward compatibility with consumers that import the const
@@ -5426,7 +5489,7 @@ declare const requirementsWriterBundle: AgentRuleBundle;
  * interpolation of the supplied `paths` struct, so a consumer override
  * of `AgentConfigOptions.paths` propagates to the rendered output.
  */
-declare function buildResearchPipelineBundle(paths?: ResolvedAgentPaths): AgentRuleBundle;
+declare function buildResearchPipelineBundle(paths?: ResolvedAgentPaths, issueDefaults?: ResolvedIssueDefaults): AgentRuleBundle;
 /**
  * Default-paths instance of the research-pipeline bundle, preserved
  * for backward compatibility with consumers that import the const