bottlenecks-mcp-server/lib/utils/template-loader.js

Model Context Protocol server for Bottlenecks database - enables AI agents like Claude to interact with bottleneck data

/**
 * Template Loader Utility
 * Embedded template to avoid path resolution issues in published package
 */
/**
 * Embedded card template - single source of truth
 * Full template content embedded to ensure availability in published package
 */
const EMBEDDED_TEMPLATE = `::: section details

Provide a comprehensive explanation of the bottleneck^[Use inline footnotes like this to add detailed references or clarifications]. This should be detailed enough for someone unfamiliar with the topic to understand the core challenge and why it matters.

## Technical Barriers

List the specific technical challenges that make this problem difficult to solve:

- Technical limitation 1 with specific details
- Technical limitation 2 with quantitative data where possible
- Technical limitation 3 with context about current approaches

## Root Causes

Identify the fundamental causes behind this bottleneck:

- **Cause 1**: Explanation of why this fundamental issue exists
- **Cause 2**: Description of structural or systemic barriers
- **Cause 3**: Analysis of resource, knowledge, or coordination gaps

## Scope

Define the scope and scale of this bottleneck:

- Industries affected
- Geographic regions impacted
- Population or market size affected
- Timeframe over which this is a critical issue

## Timeline

**Emergence**: When this bottleneck first became apparent
**Current phase**: What stage of development/urgency we're in now (2024-2025)
**Critical period**: The window when this needs to be solved

::: section impact

## Economic Cost

Provide specific cost estimates where possible, or indicate ranges and uncertainty.

**Cost to Solve**

- Estimate: $[X] billion
- Range: $[Y] - $[Z] billion
- Currency: USD
- Confidence: High/Medium/Low
- Assumptions: [Key assumptions about the estimate]

**Cost of Inaction**

- Annual cost: $[X] billion per year
- Total cost over [N] years: $[Y] billion
- Confidence: High/Medium/Low

**Timeframe to Solve**

- Estimated timeframe: [X] years
- Range: [Y] - [Z] years
- Confidence: High/Medium/Low
- Key milestones: [Major steps required]

## Market Impact

Describe how this bottleneck affects markets, industries, and economic activity. Include quantitative impacts where available.

## People Impact

Explain how this bottleneck affects individuals, communities, and society. Focus on human outcomes and quality of life impacts.

## Environmental Impact

Detail environmental consequences of this bottleneck persisting, including climate, ecosystem, and resource impacts.

::: section efforts

::: subsection industry-led

### [Company/Organization Name]

**[Project Name]**

- **Stage**: [Early/Growth/Mature/Public]
- **Project**: Brief description of the initiative
- **Funding**: Amount raised or invested
- **Timeline**: Start date - expected completion
- **Status**: Current phase and key milestones

### [Another Organization]

**[Another Project]**

- **Stage**: [Early/Growth/Mature/Public]
- **Project**: Description
- **Investment**: Funding details
- **Timeline**: Project timeline
- **Status**: Current progress

::: subsection government-research

### [Government Agency/Program]

- **Initiative**: Program description
- **Funding**: Budget allocated
- **Timeline**: Program duration
- **Focus**: Key areas of research/development

### [Research Institution/University]

- **Initiative**: Research program description
- **Funding**: Grant amounts and sources
- **Focus**: Specific research areas and approaches

::: subsection non-profit-academic

### Non-Profit & Academic Initiatives

**[Non-Profit Organization/Foundation]**

- **Initiative**: Description of non-profit efforts
- **Funding**: Grant amounts and fundraising targets
- **Timeline**: Project duration and milestones
- **Impact**: Expected outcomes and beneficiaries

**[Academic Institution/Research Center]**

- **Research**: Specific research programs and methodologies
- **Collaboration**: Industry partnerships and academic consortiums
- **Timeline**: Research phases and publication goals
- **Funding**: Grant sources and amounts

::: subsection startups

### Startups

**[Startup Name]**

- **Product/Service**: Description of startup's approach to the bottleneck
- **Funding**: Amount raised and funding rounds
- **Timeline**: Key milestones and development phases
- **Status**: Current progress and market position

::: subsection funding-mechanics

### Funding Mechanics

**[Funding Mechanism/Program Name]**

- **Type**: [Grant program/Prize competition/Tax incentive/etc.]
- **Description**: How the funding mechanism works
- **Eligibility**: Who can apply or participate
- **Amount**: Funding amounts available
- **Timeline**: Application deadlines and program duration
- **Status**: Current availability and recent awards

::: section related

- URL stubs of related bottlenecks and a description of relation causality.

::: section approach

::: subsection incentive-structures

## Incentive Structures

What incentives would drive breakthrough progress on this bottleneck?

- **Research & academic incentives**: [Describe academic rewards, publications, career advancement]
- **Market & commercial incentives**: [Describe profit opportunities, market advantages, competitive benefits]
- **Policy & regulatory incentives**: [Describe regulatory benefits, policy support, compliance advantages]
- **Social impact incentives**: [Describe societal benefits, mission alignment, impact recognition]

Select and focus on the most critical incentives for this specific problem.

::: subsection recommended-funding

## Recommended Funding

What funding would be most effective? Choose the most promising option(s):

- **Government funding** (agencies, grants, programs)
- **Foundation/philanthropic funding** (mission-aligned foundations)
- **Venture capital** (commercial potential)
- **Corporate partnerships** (strategic industry value)
- **Hybrid models** (combinations of sources)

Focus on the 1-2 most promising funding paths rather than covering all options.

::: subsection optimal-organization

## Optimal Organization

What organizational model would work best? Select the most promising approach:

- **Academic research** (universities, institutes)
- **Think tanks** (policy focus)
- **For-profit startups** (market-driven)
- **Non-profits** (mission-driven)
- **BBN-style models** (autonomous research teams)
- **FROs** (focused research organizations)
- **Public-private partnerships**
- **Government agencies/labs**
- **AI agents/automation**
- **Hybrid human-AI teams**
- **Other ideas** (if none of the above fit well)

Focus on the 1-2 most promising organizational paths rather than covering all options. If you can't find a good fit from this list, add other ideas.

::: subsection recommended-approach

## Author's Recommended Approach

- **Recommended approach**: [Your top choice for organization + funding]
- **Why this approach**: [Brief rationale]
- **Next steps**: [Key actions to move forward]

::: subsection funding-proposal

## Funding + Support Proposal

- **Total funding needed**: $[X] million over [Y] years
- **Funding breakdown**:
  - [Specific use 1]: $[Amount] million ([X]% of total)
  - [Specific use 2]: $[Amount] million ([X]% of total)
  - [Specific use 3]: $[Amount] million ([X]% of total)
- **Funding mechanism**: [How the money would be distributed - e.g., "Each research team would receive $X-Y million per year for Z years" or "Single organization with $X million upfront and $Y million milestone-based payments"]

_Example: "Each focused research team would receive $5-15 million per year for 4 years, supporting 10-30 researchers working on complementary approaches to this bottleneck, with 20% reserved for infrastructure and 30% renewal cap to maintain portfolio dynamism."_

::: section forecast

## Future Scenarios

Describe 2-3 potential development paths for this bottleneck based on current trends and possible developments.

::: subsection scenario-1

[Brief description of what changes in this scenario]

**Why It Happens:**

- Key factor 1 that drives this outcome
- Key factor 2 that enables this change
- Key factor 3 that supports this scenario

**What It Means:**
Explain the implications - does the bottleneck disappear, shift, or multiply? What are the broader consequences?

**When:**

- _Early signs:_ [Year range]
- _Full effect:_ [Year range]

**Likelihood:** [HIGH | MEDIUM | LOW]
Brief explanation of why you assess this probability.

**Scenario Type:** "[DISAPPEARS | SHIFTS | MULTIPLIES]"

**Timeframe:** "[SHORT_TERM | MEDIUM_TERM | LONG_TERM]"

::: subsection scenario-2

[Brief description of what changes in this scenario]

**Why It Happens:**

- Key factor 1 that drives this outcome
- Key factor 2 that enables this change
- Key factor 3 that supports this scenario

**What It Means:**
Explain the implications - does the bottleneck disappear, shift, or multiply? What are the broader consequences?

**When:**

- _Early signs:_ [Year range]
- _Full effect:_ [Year range]

**Likelihood:** [HIGH | MEDIUM | LOW]
Brief explanation of why you assess this probability.

**Scenario Type:** "[DISAPPEARS | SHIFTS | MULTIPLIES]"

**Timeframe:** "[SHORT_TERM | MEDIUM_TERM | LONG_TERM]"

::: subsection scenario-3

[Brief description of what changes in this scenario]

**Why It Happens:**

- Key factor 1 that drives this outcome
- Key factor 2 that enables this change
- Key factor 3 that supports this scenario

**What It Means:**
Explain the implications - does the bottleneck disappear, shift, or multiply? What are the broader consequences?

**When:**

- _Early signs:_ [Year range]
- _Full effect:_ [Year range]

**Likelihood:** [HIGH | MEDIUM | LOW]
Brief explanation of why you assess this probability.

**Scenario Type:** "[DISAPPEARS | SHIFTS | MULTIPLIES]"

**Timeframe:** "[SHORT_TERM | MEDIUM_TERM | LONG_TERM]"

::: section considerations

## Risk Analysis

Describe 2-3 potential risks and considerations around this bottleneck based on current trends and possible developments.

::: subsection scenario-1

[Brief description of what changes in this scenario]

**Impact:** "[CRITICAL | HIGH | MEDIUM | LOW]"

**Likelihood:** "[HIGH | MEDIUM | LOW]"

**Risk Analysis Type:** "[RISK_IF_SOLVED | RISK_IF_NOT_SOLVED | RISK_IF_PARTIALLY_SOLVED | INHERENT_RISK]"

**What Happens**
Describe the specific negative outcome if this bottleneck is not resolved.

**Why It Occurs**
Explain the causal chain from unsolved bottleneck to negative outcome.

**Mitigation Strategies**

- Alternative approach 1
- Risk reduction strategy 2
- Damage limitation option 3

**Affected Areas**
List the specific affected groups/sectors - these will appear as tags/badges in the interface

::: subsection scenario-2

[Brief description of what changes in this scenario]

**Impact:** "[CRITICAL | HIGH | MEDIUM | LOW]"

**Likelihood:** "[HIGH | MEDIUM | LOW]"

**Risk Analysis Type:** "[RISK_IF_SOLVED | RISK_IF_NOT_SOLVED | RISK_IF_PARTIALLY_SOLVED | INHERENT_RISK]"

**What Happens**
Describe the specific negative outcome if this bottleneck is not resolved.

**Why It Occurs**
Explain the causal chain from unsolved bottleneck to negative outcome.

**Mitigation Strategies**

- Alternative approach 1
- Risk reduction strategy 2
- Damage limitation option 3

**Affected Areas**
List the specific affected groups/sectors - these will appear as tags/badges in the interface

::: subsection scenario-3

[Brief description of what changes in this scenario]

**Impact:** "[CRITICAL | HIGH | MEDIUM | LOW]"

**Likelihood:** "[HIGH | MEDIUM | LOW]"

**Risk Analysis Type:** "[RISK_IF_SOLVED | RISK_IF_NOT_SOLVED | RISK_IF_PARTIALLY_SOLVED | INHERENT_RISK]"

**What Happens**
Describe the specific negative outcome if this bottleneck is not resolved.

**Why It Occurs**
Explain the causal chain from unsolved bottleneck to negative outcome.

**Mitigation Strategies**

- Alternative approach 1
- Risk reduction strategy 2
- Damage limitation option 3

**Affected Areas**
List the specific affected groups/sectors - these will appear as tags/badges in the interface

::: section resources

Academic papers, industry reports, and data sources supporting this analysis.

### References

Numbered references are automatically generated from inline footnotes (^[text]) throughout the document.

### Additional Resources

Supplementary materials, datasets, and related documentation.

### Primary Sources

**[Paper Title] ([Year]): "[Full title]"**

- Sections: Which parts of this card draw from this source
- DOI: [Digital Object Identifier if available]
- Key findings: Brief summary of relevant findings

**[Report Title] ([Year]): "[Full title]"**

- Sections: Which parts of this card cite this source
- Publisher: [Organization that published]
- Key data: Specific statistics or findings used

### Industry Reports

- **[Organization] [Report Name] [Year]**
- **[Another Report] [Year]**
- **[Third Report] [Year]**

### Data Sources

- **[Statistical Source]**: [Brief description of data used]
- **[Database/API]**: [Description of quantitative data]
- **[Survey/Study]**: [Description of primary research cited]

::: section contributors

## Contributors

Individuals who have contributed to this analysis.

### Primary Authors

**[Author Name]** - [Title], [Institution]

- Sections: [Which sections they primarily authored]
- Expertise: [Relevant background and qualifications]
- Contact: [ORCID or institutional affiliation]

### Reviewers

**[Reviewer Name]** - [Title], [Institution]

- Review focus: [What aspects they reviewed]
- ORCID: [ORCID identifier if available]

### Contributors

**[Contributor Name]** - [Role in creation]

- Contribution: [Specific contribution - data, research, analysis, etc.]

### AI Assistance

**[AI System Name] ([Organization])** - [Type of assistance provided]

- Sections: [Which sections had AI assistance]
- Human oversight: [Description of human review and validation]
- Limitations: [Any known limitations or biases in AI contribution]`;
/**
 * Load the card template - uses embedded version for published package
 */
export function getCardTemplate() {
    return EMBEDDED_TEMPLATE;
}
/**
 * Fill template placeholders with actual values
 */
export function fillTemplate(template, values) {
    let filled = template;
    if (values.title) {
        filled = filled.replace(/\{title\}/g, values.title);
    }
    if (values.description) {
        filled = filled.replace(/\{description\}/g, values.description);
    }
    return filled;
}
//# sourceMappingURL=template-loader.js.map