Regulatory Guardrail Component Guide — USLaunchStack Engineering

🔌 How to Wire Components

All components are available via the global window.USLaunchStack object — loaded automatically from index.html.

⚖️ Mandatory Before Go-Live: All paid formation/advisory features MUST use these components. Owner requirement — no feature ships without proper guardrails.

ℹ️ Acknowledgment versioning: The ACK_VERSION constant in the guardrail script controls re-acknowledgment. Bump it when disclaimer text changes to force all users to re-acknowledge.

Component 1 — Intake Acknowledgment Modal

Blocks access to formation/advisory features until user checks all required acknowledgments. Stored in localStorage per feature type per version.

Usage

API Reference

HOW TO USE

// Option A: Require acknowledgment before feature action
// If already acknowledged → runs callback immediately
// If not acknowledged → shows modal, then runs callback on proceed

USLaunchStack.requireAcknowledgment('formation', function() {
    // User has acknowledged — unlock feature here
    openEntityFormationWizard();
});

// Option B: Check acknowledgment without showing modal
if (USLaunchStack.checkAcknowledged('formation')) {
    showFeature();
} else {
    showLockedState();
}

// Option C: Auto-gate any button/link with class + data attr
// No JS needed — the guardrail system hooks these automatically

<!-- Formation feature gate (5 standard checkboxes) -->
<button class="btn btn-primary requires-ack"
        data-ack-type="formation"
        data-onclick="openEntityWizard()">
    Start Entity Formation
</button>

<!-- FinCEN BOI feature gate (5 standard + 2 FinCEN checkboxes) -->
<button class="btn btn-primary requires-ack"
        data-ack-type="fincen"
        data-onclick="openBoiWizard()">
    Start BOI Filing
</button>

Method	Parameters	Returns	Description
requireAcknowledgment(type, cb)	type: 'formation'\|'fincen', cb: function	void	Show modal if not acknowledged. Run cb after proceed or immediately if already acked.
checkAcknowledged(type)	type: 'formation'\|'fincen'	boolean	Check localStorage for stored acknowledgment at current version.

⚠️ Acknowledgment Storage: Key format: usl_ack_{featureType}_v{ACK_VERSION}. Version is set to 1.1 in the script. Bump ACK_VERSION in index.html to invalidate all stored acknowledgments.

Component 2 — Feature-Level Disclaimer Banner

Prominent banner displayed at the top of every formation/advisory feature page. Must be visible without scrolling.

Usage

Formation Preview

FinCEN Preview

// Method A: JavaScript injection (dynamic pages)
// Add a container div at the TOP of your feature page:
<div id="featureBanner"></div>

// Then inject the banner on page load:
USLaunchStack.showBanner('formation', 'featureBanner');
// or for FinCEN features:
USLaunchStack.showBanner('fincen', 'featureBanner');

// Method B: Static HTML (server-rendered pages)
// Copy the HTML from the Formation or FinCEN preview tabs.

Required: Banner must appear at the TOP of the feature page content, visible without scrolling on desktop and mobile.

LIVE PREVIEW — FORMATION VARIANT

USLaunchStack does NOT employ licensed attorneys and does NOT provide legal services. Entity formation requires analysis of your specific business structure, liability, tax, and regulatory needs — advice that constitutes legal practice. USLaunchStack's formation outputs are templates only and do NOT substitute for attorney review. All formation decisions require review by a licensed attorney in the state where your entity will be formed.

USLaunchStack does NOT provide tax advice. Tax planning for business entities requires engagement of a licensed CPA or Enrolled Agent (EA). For tax questions, you MUST consult a CPA, EA, or tax attorney.

LIVE PREVIEW — FINCEN BOI VARIANT

FinCEN beneficial ownership reporting requirements are complex and subject to frequent updates. USLaunchStack's BOI guidance is educational reference only. All beneficial ownership reporting must be prepared and certified by the designated responsible filer.

You are personally liable for BOI filing accuracy under 31 USC §5336. You MUST verify current FinCEN requirements and consult a compliance attorney before filing.

Component 3 — Output-Level Warning Block

Wraps EVERY AI-generated output. Required on all reports, analyses, recommendations, entity comparisons, and tax comparisons.

Usage

Formation Preview

FinCEN Preview

// Inject after every AI-generated output block:
<div id="outputWarning"></div>

USLaunchStack.showOutputWarning('formation', 'outputWarning');
// or for FinCEN:
USLaunchStack.showOutputWarning('fincen', 'outputWarning');

// Pattern: inject immediately after streaming completes
streamAIOutput(prompt, outputDiv).then(function() {
    USLaunchStack.showOutputWarning('formation', 'warningDiv');
});

MANDATORY: Every AI output — every entity comparison, tax analysis, formation recommendation, document template, jurisdiction analysis — MUST have this warning block appended.

LIVE PREVIEW — FORMATION VARIANT

⚖️ Business Formation Notice — Educational Reference Only

This USLaunchStack output is EDUCATIONAL TEMPLATE REFERENCE MATERIAL ONLY. It is NOT:

Legal advice regarding entity structure
Customized formation documents for your business
A substitute for licensed attorney review
Tax advice regarding entity selection

BEFORE forming your business entity:

CONSULT A LICENSED ATTORNEY regarding entity type, liability protection, state-specific requirements, and governance terms
CONSULT A CPA OR ENROLLED AGENT regarding tax implications, federal employment tax, foreign investor tax compliance, and state tax registration
VERIFY CURRENT REQUIREMENTS with your State Secretary of State website

All formation documents must be customized by your attorney for your specific situation before filing with the state. State requirements vary and change frequently; verify current requirements. Does not constitute legal or tax services.

LIVE PREVIEW — FINCEN BOI VARIANT

📋 FinCEN Beneficial Ownership Information (BOI) Notice

You are PERSONALLY LIABLE for BOI filing accuracy under 31 USC §5336. Civil penalties up to $500 per day for non-filing or inaccurate information.

Before filing:

Verify current FinCEN BOI requirements at fincen.gov
Consult a compliance attorney
Designate the responsible filer
Ensure all beneficial owner information is accurate

USLaunchStack's BOI guidance is educational reference only and does not constitute compliance counseling. This is not a substitute for licensed attorney review.

Component 4 — Inline Contextual Caveats

Tooltip and inline alert components for specific trigger contexts. Use when displaying entity recommendations, tax benefits, or jurisdiction advice.

Usage

Live Preview

// Inject inline tooltip caveat after sensitive text
// Returns HTML string — inject with innerHTML += or textContent

// 5 caveat types:
entityLabel.innerHTML += USLaunchStack.inlineCaveat('entity');
// "Entity selection depends on your specific tax situation..."

taxLabel.innerHTML += USLaunchStack.inlineCaveat('tax');
// "This is not tax advice. Consult a CPA or EA..."

stateLabel.innerHTML += USLaunchStack.inlineCaveat('state');
// "State requirements change frequently..."

jurisdictionLabel.innerHTML += USLaunchStack.inlineCaveat('jurisdiction');
// "Jurisdiction choice depends on specific business needs..."

foreignLabel.innerHTML += USLaunchStack.inlineCaveat('foreign');
// "Foreign investor tax compliance requires a CPA/EA/tax attorney"

// Inline alert block (non-tooltip, always visible)
container.innerHTML += USLaunchStack.inlineAlert(
    'This is not tax advice; consult a CPA or EA about entity structure.'
);

LIVE PREVIEW — HOVER THE ! ICONS

Entity Recommendation: Delaware C-Corporation ! Entity selection depends on your specific tax situation, liability exposure, and business plans. Consult a CPA/EA (for tax) and an attorney in your state (for legal) before deciding.

Tax Benefit: Pass-through taxation available ! This is not tax advice. Consult a CPA or EA about tax implications of entity structure.

Jurisdiction: Delaware recommended ! Jurisdiction choice depends on specific business needs and tax situation. Consult your attorney and CPA before selecting.

⚠️ This is not tax advice; consult a CPA or EA about entity structure tax implications.

Component 5 — TOS Addendum

Already deployed on legal.html. Reference this page from all feature footers and the navigation bar.

<!-- Link to TOS from all feature pages -->
<a href="legal.html#tos-addendum">Terms of Service</a>
<a href="legal.html#privacy">Privacy Policy</a>
<a href="legal.html#no-legal">Legal Disclaimers</a>

<!-- Anchor links for specific sections:
  #critical-notice  — top regulatory notice
  #no-legal         — UPL disclaimer
  #no-tax           — tax advice prohibition
  #fincen           — FinCEN BOI liability
  #formation-disclaimer — formation feature disclaimer
  #output-disclaimer    — AI output disclaimer
  #safe-harbor      — approved safe harbor phrases
  #prohibited       — prohibited statements list
  #tos-addendum     — required TOS addendum text
  #privacy          — privacy policy
-->

✅ Post-Build Verification Checklist

Run through this before marking any formation/advisory feature as ready for review:

1. Gate Enforcement

All intake disclaimers appear BEFORE users can access AI outputs (gate, not just display)

2. Output Coverage

All output-level warnings appear on EVERY report/analysis/recommendation

3. Safe Harbor Language

Safe Harbor phrases appear in AI-generated outputs (check 3 random outputs)

4. UI Guardrails

Test each prohibited pattern — no entity rec without caveat, no "minimizes taxes" claims

5. Ack Persistence

Acknowledged users skip modal on return visit. Bump ACK_VERSION to re-require on all users.

6. Banner Visibility

Disclaimer banners visible without scrolling on feature pages (desktop + mobile)

Component Developer Guide

🔌 How to Wire Components

✅ Post-Build Verification Checklist