forgesmith 0.6.1 → 0.7.1

package/dist/server.d.cts

@@ -25,7 +25,7 @@ interface PrismData {
     toDate?: string;
 }
 interface ReleaseNotesOpts {
-    tone?: "professional" | "casual" | "technical";
+    tone?: "professional" | "casual" | "technical" | "executive";
     length?: "short" | "medium" | "long";
     format?: "markdown" | "plain";
 }
@@ -60,7 +60,7 @@ interface BlueprintData {
     };
 }
 interface ArchitectureWalkthroughOpts {
-    tone?: "technical" | "casual" | "onboarding";
+    tone?: "professional" | "casual" | "technical" | "executive";
     length?: "short" | "medium" | "long";
     format?: "markdown" | "plain";
 }
@@ -70,12 +70,12 @@ interface ChangesSinceOpts {
     format?: "markdown" | "plain";
 }
 interface OnboardingDocOpts {
-    tone?: "friendly" | "formal" | "technical";
+    tone?: "professional" | "casual" | "technical" | "executive";
     length?: "short" | "medium" | "long";
     format?: "markdown" | "plain";
 }
 interface RefactoringReportOpts {
-    tone?: "analytical" | "casual" | "executive";
+    tone?: "professional" | "casual" | "technical" | "executive";
     length?: "short" | "medium" | "long";
     format?: "markdown" | "plain";
 }
@@ -97,6 +97,61 @@ interface GenerationResult {
 declare function readPrismDirectory(prismPath: string): Promise<PrismData>;
 declare function readBlueprintData(targetPath: string): Promise<BlueprintData | null>;
 
+interface AmberCapabilityContext {
+    id: string;
+    name: string;
+    criticality: "critical" | "high" | "medium" | "low";
+    lifecycle: "active" | "experimental" | "deprecated" | "sunset";
+    description?: string;
+    /** Files tagged with this capability in state.json */
+    files: string[];
+    /** Files tagged with this capability that have no doc_hash (outdated @amber-doc) */
+    driftCount: number;
+    /** Whether any file in this capability's set has a doc_hash (proxy for test coverage) */
+    hasTests: boolean;
+}
+interface AmberLayerContext {
+    capabilities: AmberCapabilityContext[];
+    totalFiles: number;
+    taggedFiles: number;
+    taggedPercent: number;
+    driftedCapabilities: number;
+    orphanedFiles: string[];
+    /** Human-readable summary for prompt injection */
+    summary: string;
+}
+/**
+ * Read the AMBER layer from a target project's .amber/ directory.
+ * Returns null when no .amber/ directory exists — callers degrade cleanly.
+ */
+declare function readAmberLayer(targetPath: string): Promise<AmberLayerContext | null>;
+
+interface GreenInsightContext {
+    id: string;
+    title: string;
+    body: string;
+    category: string;
+    severity?: string;
+}
+interface GreenLayerContext {
+    insights: GreenInsightContext[];
+    coherenceScore: number | null;
+    coherenceGrade: string | null;
+    topRisks: Array<{
+        capabilityId: string;
+        name: string;
+        reason: string;
+        impact: number;
+    }>;
+    /** Human-readable summary for prompt injection */
+    summary: string;
+}
+/**
+ * Read the GREEN layer from a target project's .prism/green/ directory.
+ * Returns null when the directory does not exist — callers degrade cleanly.
+ */
+declare function readGreenLayer(targetPath: string): Promise<GreenLayerContext | null>;
+
 type ScopeKind = "framework" | "app" | "tenant";
 type SignalKind = "brief" | "knowledge_ref" | "git_range" | "app_feature_ref" | "business_capability_ref" | "amber_capability_ref" | "platform_walkthrough" | "green_insight_ref";
 type Channel = "heise" | "connect" | "linkedin" | "instagram" | "landing" | "onepager" | "internal" | "email" | "deck" | "x" | "product_hunt" | "presentation";
@@ -200,10 +255,26 @@ interface FileEntry {
 declare function scanForSecrets(text: string): boolean;
 
 /**
- * Reads a blueprint from the target project.
- * Tries: {targetPath}/.prism/blueprint/snapshot.json (preferred, legacy format)
- * then: {targetPath}/.prism/blueprint.json
- * Returns null if neither file exists or if path is unsafe.
+ * Converts a prismlens `blueprint.json` (prism0x2A on-disk format) into the
+ * canonical `BlueprintData` shape used by forgesmith's generators and UI.
+ *
+ * Mapping:
+ *   prismlens.nodes[]           → BlueprintData.files[]
+ *   prismlens.edges[]           → BlueprintData.edges[] (source/target → from/to)
+ *   prismlens.summary.fileCount → BlueprintData.stats.totalFiles
+ *   prismlens.summary.runtimeInternalDependencyCount → BlueprintData.stats.runtimeEdges
+ *   prismlens.summary.*Count    → BlueprintData.categories
+ *   prismlens.heatmap / mostImportedFiles → importedByCount approximation on files
+ */
+declare function normalizePrismlensBlueprint(raw: unknown, targetPath?: string): BlueprintData;
+/**
+ * Reads a blueprint from the target project and returns a canonical BlueprintData.
+ *
+ * Resolution order:
+ *   1. {targetPath}/.prism/blueprint/snapshot.json  — native BlueprintData shape; no conversion needed
+ *   2. {targetPath}/.prism/blueprint.json           — prismlens shape; normalized via normalizePrismlensBlueprint()
+ *
+ * Returns null if neither file exists, if the path is unsafe, or if JSON is malformed.
  */
 declare function readBlueprintFromTarget(targetPath: string): BlueprintData | null;
 
@@ -340,21 +411,581 @@ interface LlmProvider {
     complete(request: LlmRequest): Promise<LlmResponse>;
 }
 
-declare function generateReleaseNotes(data: PrismData, opts: ReleaseNotesOpts, provider: LlmProvider): Promise<GenerationResult>;
+declare function generateReleaseNotes(data: PrismData, opts: ReleaseNotesOpts, provider: LlmProvider, amberContext?: AmberLayerContext, greenContext?: GreenLayerContext): Promise<GenerationResult>;
 
-declare function generateArchitectureWalkthrough(blueprint: BlueprintData | null, opts: ArchitectureWalkthroughOpts, provider: LlmProvider): Promise<GenerationResult>;
+declare function generateArchitectureWalkthrough(blueprint: BlueprintData | null, opts: ArchitectureWalkthroughOpts, provider: LlmProvider, amberContext?: AmberLayerContext): Promise<GenerationResult>;
 
 declare function generateChangesSince(current: BlueprintData | null, previous: BlueprintData | null, opts: ChangesSinceOpts, provider: LlmProvider): Promise<GenerationResult>;
 
 declare function generateOnboardingDoc(blueprint: BlueprintData | null, opts: OnboardingDocOpts, provider: LlmProvider): Promise<GenerationResult>;
 
-declare function generateRefactoringReport(blueprint: BlueprintData | null, opts: RefactoringReportOpts, provider: LlmProvider): Promise<GenerationResult>;
+declare function generateRefactoringReport(blueprint: BlueprintData | null, opts: RefactoringReportOpts, provider: LlmProvider, amberContext?: AmberLayerContext, greenContext?: GreenLayerContext): Promise<GenerationResult>;
 
 declare function generateAskDrivenAsset(blueprint: BlueprintData | null, question: string, opts: AskDrivenAssetOpts, provider: LlmProvider): Promise<GenerationResult>;
 
-type WidgetKind = "stat-card" | "feature-grid" | "testimonial" | "cta-banner" | "metric-badge" | "pricing-tier" | "changelog-row" | "social-proof";
+type PresentationSlideType = "title" | "executive" | "architecture" | "capabilities" | "health" | "risks" | "recommendations" | "metrics" | "closing";
+interface PresentationSlide {
+    type: PresentationSlideType;
+    title: string;
+    subtitle?: string;
+    bullets?: string[];
+    highlight?: string;
+    highlightLabel?: string;
+    speakerNotes?: string;
+    visualHint?: string;
+}
+interface PresentationOutput {
+    title: string;
+    subtitle: string;
+    slideCount: number;
+    slides: PresentationSlide[];
+    theme: "dark" | "light" | "corporate";
+    generatedAt: string;
+}
+interface GeneratePresentationOpts {
+    blueprint: BlueprintData;
+    audience: "technical" | "executive" | "mixed";
+    slideCount: 5 | 8 | 10 | 12;
+    theme: "dark" | "light" | "corporate";
+    focusArea?: "architecture" | "health" | "risks" | "all";
+    tone: "professional" | "casual" | "executive";
+    projectName?: string;
+    llm: LlmProvider;
+}
+declare function generatePresentation(opts: GeneratePresentationOpts): Promise<PresentationOutput>;
+
+type ComplianceFramework = "SOX" | "ISO27001" | "GDPR" | "SOC2" | "CUSTOM";
+interface ComplianceCapabilityRecord {
+    id: string;
+    name: string;
+    criticality: "critical" | "high" | "medium" | "low";
+    lifecycle: "active" | "experimental" | "deprecated" | "sunset";
+    files: string[];
+    testCoverage: boolean;
+    driftCount: number;
+    description?: string;
+    dataProcessing?: boolean;
+    accessControl?: boolean;
+    auditTrail?: boolean;
+}
+interface ComplianceContext {
+    framework: string;
+    projectName: string;
+    generatedAt: string;
+    totalCapabilities: number;
+    criticalCapabilities: ComplianceCapabilityRecord[];
+    riskSummary: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+    sox?: {
+        financialCapabilities: string[];
+        accessControlled: string[];
+    };
+    gdpr?: {
+        dataProcessingCapabilities: string[];
+        retentionCapabilities: string[];
+    };
+    iso27001?: {
+        informationAssets: string[];
+        securityControls: string[];
+    };
+    soc2?: {
+        securityCapabilities: string[];
+        availabilityCapabilities: string[];
+    };
+}
+interface GenerateComplianceDocOpts {
+    blueprint: BlueprintData;
+    amberContext?: AmberLayerContext;
+    complianceContext?: ComplianceContext;
+    framework: ComplianceFramework;
+    customFramework?: string;
+    projectName: string;
+    organizationName?: string;
+    tone: "formal" | "technical" | "executive";
+    includeRecommendations: boolean;
+    llm: LlmProvider;
+}
+interface ComplianceSection {
+    title: string;
+    content: string;
+    capabilities: string[];
+    riskLevel?: "high" | "medium" | "low";
+    status?: "compliant" | "partial" | "gap";
+}
+interface ComplianceDocOutput {
+    framework: ComplianceFramework;
+    documentTitle: string;
+    sections: ComplianceSection[];
+    executiveSummary: string;
+    complianceGaps: string[];
+    recommendations: string[];
+    generatedAt: string;
+    confidentiality: "INTERNAL" | "CONFIDENTIAL" | "PUBLIC";
+}
+declare function generateComplianceDoc(opts: GenerateComplianceDocOpts): Promise<ComplianceDocOutput>;
+
+interface AdrContext {
+    importCycles: Array<{
+        files: string[];
+        severity: "tight" | "chain" | "web";
+    }>;
+    capabilityBoundaries: Array<{
+        from: string;
+        to: string;
+        edgeCount: number;
+    }>;
+    highChurnFiles: Array<{
+        path: string;
+        commits: number;
+        capabilities: string[];
+    }>;
+    orphanedFiles: string[];
+    coherenceScore: number | null;
+    topRisks: Array<{
+        capabilityId: string;
+        name: string;
+        reason: string;
+    }>;
+    architecturalPatterns: string[];
+}
+interface GenerateADROpts {
+    blueprint: BlueprintData;
+    amberContext?: AmberLayerContext;
+    adrContext?: AdrContext;
+    focus: "cycles" | "capabilities" | "dependencies" | "overall";
+    selectedCycle?: string[];
+    selectedCapability?: string;
+    projectName: string;
+    llm: LlmProvider;
+}
+interface ADRDocument {
+    id: string;
+    title: string;
+    date: string;
+    status: "Proposed" | "Accepted" | "Deprecated" | "Superseded";
+    context: string;
+    decision: string;
+    consequences: {
+        positive: string[];
+        negative: string[];
+        neutral: string[];
+    };
+    alternatives: string[];
+    relatedCapabilities: string[];
+    relatedFiles: string[];
+}
+interface ADROutput {
+    adrs: ADRDocument[];
+    summary: string;
+    technicalDebt: string;
+}
+declare function generateADR(opts: GenerateADROpts): Promise<ADROutput>;
+
+interface GitRangeContext$1 {
+    commits: Array<{
+        hash: string;
+        subject: string;
+        author?: string;
+        date?: string;
+        files?: string[];
+    }>;
+    fromRef: string;
+    toRef: string;
+    filesChanged: number;
+}
+interface GenerateSprintRetroOpts {
+    gitContext?: GitRangeContext$1;
+    amberContext?: AmberLayerContext;
+    greenContext?: GreenLayerContext;
+    scoreBefore?: number;
+    scoreAfter?: number;
+    sprintName?: string;
+    teamSize?: number;
+    projectName: string;
+    tone: "professional" | "casual" | "team-friendly";
+    llm: LlmProvider;
+}
+interface SprintRetroOutput {
+    sprintName: string;
+    period: string;
+    summary: string;
+    delivered: Array<{
+        item: string;
+        capability?: string;
+        type: "feature" | "fix" | "refactor" | "chore";
+    }>;
+    healthDelta: {
+        scoreBefore: number | null;
+        scoreAfter: number | null;
+        delta: number | null;
+        verdict: "improved" | "stable" | "degraded";
+        degradedCapabilities: string[];
+    };
+    wentWell: string[];
+    improvements: string[];
+    puzzles: string[];
+    actions: string[];
+    debtIncurred: string[];
+    slideTitle: string;
+    slidePoints: string[];
+}
+declare function generateSprintRetro(opts: GenerateSprintRetroOpts): Promise<SprintRetroOutput>;
+
+/**
+ * WeeklyDigestContext — shared type for the 7-day engineering digest.
+ *
+ * Produced by PRISM's /api/green/weekly-digest route and consumed by the
+ * generateNewsletter generator. Kept here as a pure type module so that
+ * both the generator and the dashboard API route can import it without
+ * a circular dependency.
+ */
+interface WeeklyDigestContext {
+    /** Human-readable period, e.g. "May 13–20, 2026" */
+    period: string;
+    /** Total commits in the window */
+    commitCount: number;
+    /** Total files touched (from git diff) */
+    filesChanged: number;
+    /** Coherence score at the start of the window */
+    scoreStart: number | null;
+    /** Coherence score at the end of the window */
+    scoreEnd: number | null;
+    /** scoreEnd - scoreStart (null if either is missing) */
+    scoreDelta: number | null;
+    /** Architecture grade letter, e.g. "A", "B+" */
+    grade: string | null;
+    /** Capabilities that newly drifted (doc hash mismatch) */
+    newDrifts: string[];
+    /** Capabilities where drift was resolved */
+    resolvedDrifts: string[];
+    /** New critical-severity risks from GREEN predictions */
+    newRisks: string[];
+    /** Top 5 commit subjects (non-technical filter applied) */
+    topCommits: string[];
+    /** Short human-readable health summary sentence */
+    healthSummary: string;
+}
+
+interface GenerateNewsletterOpts {
+    digestContext: WeeklyDigestContext;
+    amberContext?: AmberLayerContext;
+    targetAudience: "product-team" | "management" | "stakeholders" | "all-hands";
+    tone: "professional" | "casual" | "accessible";
+    includeMetrics: boolean;
+    projectName: string;
+    teamName?: string;
+    llm: LlmProvider;
+}
+interface NewsletterSection {
+    heading: string;
+    body: string;
+    type: "highlight" | "metrics" | "risk" | "shoutout" | "upcoming";
+}
+interface NewsletterMetric {
+    label: string;
+    value: string;
+    trend: "up" | "down" | "stable";
+}
+interface NewsletterOutput {
+    subject: string;
+    preview: string;
+    greeting: string;
+    headline: string;
+    sections: NewsletterSection[];
+    metrics: NewsletterMetric[];
+    closing: string;
+    unsubscribeNote: string;
+    slackVersion: string;
+    teamsVersion: string;
+    htmlVersion: string;
+}
+declare function generateNewsletter(opts: GenerateNewsletterOpts): Promise<NewsletterOutput>;
+
+interface RadioOptions {
+    digestContext: WeeklyDigestContext;
+    amberContext?: AmberLayerContext;
+    audience: "technical" | "executive";
+    projectName: string;
+    llm: LlmProvider;
+}
+interface RadioResult {
+    headline: string;
+    slackVersion: string;
+    emailVersion: string;
+    twitterVersion: string;
+}
+declare function generateRadio(options: RadioOptions): Promise<RadioResult>;
+
+/**
+ * arc42 Documentation Generator
+ *
+ * Generates complete arc42 architecture documentation.
+ *
+ * arc42 is published under Creative Commons Attribution 4.0 International.
+ * Required attribution: arc42 template © arc42.org, CC-BY 4.0
+ * See: https://arc42.org/license
+ *
+ * This module generates content for all 12 arc42 sections using a mix of:
+ *   - PRISM data (no LLM needed)        → sections 5, 9, 10, 11, 12
+ *   - LLM generation                    → sections 1, 3, 4, 8
+ *   - Template with placeholders        → sections 2, 6, 7
+ */
+
+interface Arc42Options {
+    digestContext: WeeklyDigestContext;
+    amberContext?: AmberLayerContext;
+    projectName: string;
+    projectDescription?: string;
+    teamSize?: number;
+    techStack?: string[];
+    llm: LlmProvider;
+}
+interface Arc42Section {
+    number: number;
+    title: string;
+    content: string;
+    dataSource: "prism" | "llm" | "template";
+}
+interface Arc42Document {
+    sections: Arc42Section[];
+    fullMarkdown: string;
+    attribution: string;
+    generatedAt: string;
+}
+declare function generateArc42(opts: Arc42Options): Promise<Arc42Document>;
+
+interface KnowledgeCaptureOptions {
+    departingDeveloper?: string;
+    focusCapabilities?: string[];
+    digestContext: WeeklyDigestContext;
+    amberContext?: AmberLayerContext;
+    projectName: string;
+    llm: LlmProvider;
+}
+interface KnowledgeCaptureSection {
+    title: string;
+    content: string;
+}
+interface KnowledgeCaptureResult {
+    markdownDoc: string;
+    sections: KnowledgeCaptureSection[];
+    criticalKnowledge: string[];
+    onboardingChecklist: string[];
+}
+declare function generateKnowledgeCapture(options: KnowledgeCaptureOptions): Promise<KnowledgeCaptureResult>;
+
+/**
+ * generateApiChangelog
+ *
+ * Generates a consumer-specific API changelog from detected API file changes.
+ * Supports three output formats: changelog, migration-guide, and release-notes.
+ * Audience-aware: internal / external / partner tone control.
+ */
+
+interface ApiChange {
+    endpoint: string;
+    changeType: "added" | "removed" | "modified" | "breaking";
+    file: string;
+    capability?: string;
+    capabilityName?: string;
+    description?: string;
+}
+interface ApiChangeContext {
+    from: string;
+    to: string;
+    changes: ApiChange[];
+    breakingChanges: ApiChange[];
+    newEndpoints: ApiChange[];
+    removedEndpoints: ApiChange[];
+    totalChanged: number;
+}
+interface GenerateApiChangelogOpts {
+    apiChangeContext: ApiChangeContext;
+    amberContext?: AmberLayerContext;
+    gitContext?: {
+        from: string;
+        to: string;
+        commitCount: number;
+        commitMessages: string[];
+    };
+    targetAudience: "internal" | "external" | "partner";
+    format: "changelog" | "migration-guide" | "release-notes";
+    projectName: string;
+    version?: string;
+    llm: LlmProvider;
+}
+interface ApiChangelogOutput {
+    version: string;
+    date: string;
+    targetAudience: string;
+    breakingChanges: Array<{
+        endpoint: string;
+        description: string;
+        migration: string;
+    }>;
+    newFeatures: Array<{
+        endpoint: string;
+        description: string;
+        example?: string;
+    }>;
+    improvements: Array<{
+        endpoint: string;
+        description: string;
+    }>;
+    deprecations: Array<{
+        endpoint: string;
+        description: string;
+        sunset?: string;
+    }>;
+    migrationGuide: string;
+    consumerImpactSummary: string;
+}
+declare function generateApiChangelog(opts: GenerateApiChangelogOpts): Promise<ApiChangelogOutput>;
+
+/**
+ * generateChangeImpactBrief
+ *
+ * Generates an executive-ready 2-page change impact brief for CTO / CAB sign-off.
+ * Consumes ChangeImpactContext from PRISM, optionally enriched with AMBER and GREEN
+ * layer data from forgesmith readers.
+ */
+
+/** Minimal git range context — populated by callers from git log. */
+interface GitRangeContext {
+    from: string;
+    to: string;
+    commitCount: number;
+    commitMessages: string[];
+    breakingChanges: string[];
+}
+/** Shape returned by PRISM /api/green/change-impact */
+interface ChangeImpactContext {
+    from: string;
+    to: string;
+    commitCount: number;
+    filesChanged: string[];
+    affectedCapabilities: Array<{
+        id: string;
+        name: string;
+        criticality: string;
+        changedFiles: string[];
+        driftCount: number;
+    }>;
+    regulatoryCapabilities: string[];
+    coherenceScoreBefore: number | null;
+    coherenceScoreAfter: number | null;
+    coherenceDelta: number | null;
+    topRisks: string[];
+    breakingChanges: string[];
+    summary: string;
+}
+interface GenerateChangeImpactBriefOpts {
+    gitContext: GitRangeContext;
+    changeImpactContext: ChangeImpactContext;
+    amberContext?: AmberLayerContext;
+    greenContext?: GreenLayerContext;
+    audience: "executive" | "technical" | "cab";
+    projectName: string;
+    releaseVersion?: string;
+    llm: LlmProvider;
+}
+interface ChangeImpactBrief {
+    title: string;
+    releaseVersion: string;
+    date: string;
+    audience: string;
+    executiveSummary: string;
+    technicalSummary: string;
+    affectedBusinessAreas: string[];
+    riskLevel: "low" | "medium" | "high" | "critical";
+    riskJustification: string;
+    complianceImpact: string;
+    rollbackComplexity: "simple" | "moderate" | "complex";
+    rollbackGuidance: string;
+    recommendedActions: string[];
+    approvalRequired: boolean;
+    metrics: {
+        commits: number;
+        filesChanged: number;
+        capabilitiesAffected: number;
+        coherenceDelta: number | null;
+    };
+}
+declare function generateChangeImpactBrief(opts: GenerateChangeImpactBriefOpts): Promise<ChangeImpactBrief>;
+
+/**
+ * generateRoiSlide.ts
+ *
+ * FORGE generator that converts a PRISM ROI estimate into a CFO-ready
+ * 5-slide executive deck. Uses LLM to craft persuasive copy; falls back
+ * to deterministic templates when the LLM is unavailable.
+ *
+ * @amber-capability forge.roi-slide
+ * @amber-doc Converts PRISM technical-debt ROI estimates into executive slide decks
+ */
+
+interface RoiBreakdownItem {
+    count: number;
+    hoursPerMonth: number;
+    cost: number;
+}
+interface RoiEstimate {
+    currentScore: number;
+    currentGrade: string;
+    estimatedMaintenanceHoursPerMonth: number;
+    maintenanceCostPerMonth: number;
+    maintenanceCostPerYear: number;
+    targetScore: number;
+    targetGrade: string;
+    savedHoursPerMonth: number;
+    savedCostPerMonth: number;
+    savedCostPerYear: number;
+    roiMultiple: number;
+    breakdown: {
+        importCycles: RoiBreakdownItem;
+        documentationDrift: RoiBreakdownItem;
+        highChurnFiles: RoiBreakdownItem;
+        orphanedCode: RoiBreakdownItem;
+    };
+    estimatedRemediationDays: number;
+    breakEvenMonths: number;
+    headline: string;
+    recommendation: string;
+}
+type RoiSlideType = "title" | "problem" | "cost-breakdown" | "scenarios" | "recommendation" | "cta";
+interface RoiSlide {
+    type: RoiSlideType;
+    title: string;
+    content: string;
+    highlight?: string;
+    highlightLabel?: string;
+    bullets?: string[];
+}
+interface RoiSlideOutput {
+    title: string;
+    slides: RoiSlide[];
+    executiveSummary: string;
+    oneLinePitch: string;
+}
+interface GenerateRoiSlideOpts {
+    roiEstimate: RoiEstimate;
+    organizationName?: string;
+    currency: "EUR" | "USD" | "GBP";
+    llm: LlmProvider;
+}
+declare function generateRoiSlide(opts: GenerateRoiSlideOpts): Promise<RoiSlideOutput>;
+
+type WidgetKind = "stat-card" | "feature-grid" | "testimonial" | "cta-banner" | "metric-badge" | "pricing-tier" | "changelog-row" | "social-proof" | "animated-stat" | "release-card" | "chart-bars" | "architecture-badge";
 type WidgetSlotType = "text" | "number" | "color" | "url" | "image-url" | "multiline" | "select";
-type WidgetExportFormat = "html" | "markdown" | "react";
+/** "html" = embeddable fragment (no CDN scripts).
+ *  "standalone" = full <!DOCTYPE html> document with Tailwind + Anime.js + Chart.js + Lucide CDN.
+ *  "markdown" = plain text/markdown.
+ *  "react" = standalone TSX component string.
+ */
+type WidgetExportFormat = "html" | "standalone" | "markdown" | "react";
 interface WidgetSlotDef {
     id: string;
     label: string;
@@ -371,6 +1002,16 @@ interface WidgetTemplate {
     slots: WidgetSlotDef[];
     exportFormats: WidgetExportFormat[];
     free_tier: boolean;
+    /** Widget plays JS animations in standalone mode */
+    animated?: boolean;
+    /** Total animation settle time in ms (for video capture timing) */
+    animDurationMs?: number;
+    /** Recommended total video duration in ms (anim + hold) */
+    videoDurationMs?: number;
+    /** Recommended render viewport width in px */
+    defaultWidth?: number;
+    /** Recommended render viewport height in px */
+    defaultHeight?: number;
 }
 interface WidgetInstanceSnapshot {
     version: number;
@@ -944,4 +1585,4 @@ declare function exportToICalendar(entries: ScheduledEntry[]): string;
 type ExportFormat = "buffer" | "hypefury" | "icalendar";
 declare function previewExport(entries: ScheduledEntry[], format: ExportFormat): string;
 
-export { ANIMATION_DURATION_PRESETS, type ArchitectureWalkthroughOpts, type ArrayField, type AskDrivenAssetFormat, type AskDrivenAssetOpts, type AssetKind, type AssetSlotsValidationErr, type AssetSlotsValidationOk, type AssetSlotsValidationResult, type AssetVersion, type AudienceId, BRAND_CONTENT_SLOT_KEYS, BUNDLED_DISPATCH_CHANNELS, BUNDLED_STYLE_PRESETS, BUNDLED_WIDGET_TEMPLATES, type BlueprintData, type BlueprintEdge, type BlueprintFile, type BooleanField, type BrandKit, type BrandKitFonts, type BrandKitLogo, type BrandKitPalette, type BrandKitSnapshot, type BrandKitVoice, type BrandPalette, type BrandThemeConfig, type ChangesSinceOpts, type Channel, type ChannelKind, type ChannelOutput, DEFAULT_ANIMATION_DURATION_SECONDS, DEFAULT_BRAND_KIT_FONTS, DEFAULT_BRAND_KIT_PALETTE, DEFAULT_BRAND_KIT_VOICE, DISPATCH_CHANNEL_BLOG, DISPATCH_CHANNEL_EMAIL, DISPATCH_CHANNEL_HN, DISPATCH_CHANNEL_INSTAGRAM, DISPATCH_CHANNEL_LINKEDIN, DISPATCH_CHANNEL_NEWSLETTER, DISPATCH_CHANNEL_REDDIT, DISPATCH_CHANNEL_SLACK, DISPATCH_CHANNEL_TWEET, type DiffEntry, type DiffResult, type DispatchAudienceContext, type DispatchBrandContext, type DispatchChannel, type DispatchRun, type ExportFormat, FORGE_AUDIENCES, FORGE_BRAND_THEME_ID, FORGE_TEMPLATES, FREE_TIER_WIDGET_IDS, type FileEntry, type ForgeAsset, type ForgeAudience, type ForgeGenerationDryRun, type ForgeGenerationError, type ForgeGenerationGenerated, type ForgeGenerationInput, type ForgeGenerationResult, type ForgeOutput, type ForgePrompt, type ForgeScope, type ForgeSignal, type ForgeStorage, type ForgeSubview, type ForgeTemplate, type ForgeThemeEntry, type FormErrors, type FormField, type FormSpec, type FormSpecOk, type FormSpecRaw, type Format, type GenerationResult, type Intent, type ListOutputsOpts, type LlmMessage, type LlmProvider, type LlmRequest, type LlmResponse, MAX_ANIMATION_DURATION_SECONDS, MIN_ANIMATION_DURATION_SECONDS, type Modality, type NumberField, type ObjectField, type OnboardingDocOpts, type OrchestrationInput, type OrchestrationResult, type OutputStatus, PRISM_TEMPLATES, PRISM_TEMPLATE_ARCHITECTURE_OVERVIEW, PRISM_TEMPLATE_REFACTOR_RATIONALE, PRISM_TEMPLATE_RELEASE_ANNOUNCEMENT, PRISM_TEMPLATE_SHIPPING_DIGEST, PRISM_TEMPLATE_ZONE_DEEPDIVE, type PrismBrandDraft, type PrismContextPrompt, type PrismData, type PrismFocus, type PrismInsight, type PrismRecommendation, type PrismSession, type PrismTemplate, type ProductTruth, type ProductTruthClaim, REFINE_COUNTDOWN_THRESHOLD, REFINE_SESSION_SOFT_CAP, REFINE_SUGGESTIONS, type ReadingLevel, type RefactoringReportOpts, type RefineAssetInput, type RefineAssetResult, type RefineLimitState, type RefineSuggestion, type ReleaseNotesOpts, type RenderWidgetInput, type ResolveBrandPaletteInput, type ResolvedTuple, STYLE_PRESET_BRUTALIST, STYLE_PRESET_DEFAULT, STYLE_PRESET_GLASSY, STYLE_PRESET_MINIMAL, type ScheduleRange, type ScheduledEntry, type ScheduledEntryMetadata, type ScheduledStatus, type SchemaDefinitionErr, type SchemaDefinitionOk, type SchemaDefinitionResult, type ScopeKind, type SignalKind, type StringField, type StyleTokens, TEMPLATE_SCHEMA_EXAMPLES, TEMPLATE_SCHEMA_GENERIC, type TokenUsage, type Tonality, type UrlBrandHints, type ValidationErr, type ValidationOk, type ValidationResult, WIDGET_TEMPLATE_CHANGELOG_ROW, WIDGET_TEMPLATE_CTA_BANNER, WIDGET_TEMPLATE_FEATURE_GRID, WIDGET_TEMPLATE_METRIC_BADGE, WIDGET_TEMPLATE_PRICING_TIER, WIDGET_TEMPLATE_SOCIAL_PROOF, WIDGET_TEMPLATE_STAT_CARD, WIDGET_TEMPLATE_TESTIMONIAL, type WidgetExportFormat, type WidgetInstance, type WidgetInstanceSnapshot, type WidgetKind, type WidgetSlotDef, type WidgetSlotType, type WidgetStyle, type WidgetStyleSnapshot, type WidgetTemplate, type Zone, applyEntryPatch, asAudienceId, assembleBrandUrlExtractionPrompt, assembleForgePrompt, brandThemeConfigToEntry, buildPrismContextPrompt, buildRevertVersion, buildScheduledEntry, buildVersion, cascadingScheduledFor, clampAnimationDuration, computeDiff, defaultBrandKit, defaultValueForField, deriveContextSummary, distill, entryInRange, exportToBufferCsv, exportToHypefuryCsv, exportToICalendar, extractBrandFromPrismBlueprint, extractDependencyHotspots, extractTopChurnFiles, extractZones, generateArchitectureWalkthrough, generateAskDrivenAsset, generateChangesSince, generateOnboardingDoc, generateRefactoringReport, generateReleaseNotes, getDispatchChannel, getPrismTemplate, getSlotValue, getStyleById, getWidgetTemplate, initialFormValues, next7DaysRange, nextVersionNumber, orchestrateDispatch, parseAndValidateSchemaDefinition, parseBrandKitFromLlmResponse, parseBrandThemeContent, parseStyleFromCss, parseStyleFromTailwindConfig, parseStyleFromTokensJson, parseThemeConfigContent, previewExport, readBlueprintData, readBlueprintFromTarget, readPrismDirectory, refineAsset, refineLimitState, renderWidget, resolveAnimatedChoice, resolveAnimationDuration, resolveBrandPalette, runForgeGeneration, scanForSecrets, schemaExampleFor, schemaToForm, templateAnimatedDefault, themeEntryToPalette, tryParseJsonObject, validateAgainstTemplateSchema, validateAssetSlots, validateFormValues, validateSchemaDefinition };
+export { type ADRDocument, type ADROutput, ANIMATION_DURATION_PRESETS, type AdrContext, type AmberCapabilityContext, type AmberLayerContext, type ApiChange, type ApiChangeContext, type ApiChangelogOutput, type Arc42Document, type Arc42Options, type Arc42Section, type ArchitectureWalkthroughOpts, type ArrayField, type AskDrivenAssetFormat, type AskDrivenAssetOpts, type AssetKind, type AssetSlotsValidationErr, type AssetSlotsValidationOk, type AssetSlotsValidationResult, type AssetVersion, type AudienceId, BRAND_CONTENT_SLOT_KEYS, BUNDLED_DISPATCH_CHANNELS, BUNDLED_STYLE_PRESETS, BUNDLED_WIDGET_TEMPLATES, type BlueprintData, type BlueprintEdge, type BlueprintFile, type BooleanField, type BrandKit, type BrandKitFonts, type BrandKitLogo, type BrandKitPalette, type BrandKitSnapshot, type BrandKitVoice, type BrandPalette, type BrandThemeConfig, type ChangeImpactBrief, type ChangeImpactContext, type ChangesSinceOpts, type Channel, type ChannelKind, type ChannelOutput, type ComplianceCapabilityRecord, type ComplianceContext, type ComplianceDocOutput, type ComplianceFramework, type ComplianceSection, DEFAULT_ANIMATION_DURATION_SECONDS, DEFAULT_BRAND_KIT_FONTS, DEFAULT_BRAND_KIT_PALETTE, DEFAULT_BRAND_KIT_VOICE, DISPATCH_CHANNEL_BLOG, DISPATCH_CHANNEL_EMAIL, DISPATCH_CHANNEL_HN, DISPATCH_CHANNEL_INSTAGRAM, DISPATCH_CHANNEL_LINKEDIN, DISPATCH_CHANNEL_NEWSLETTER, DISPATCH_CHANNEL_REDDIT, DISPATCH_CHANNEL_SLACK, DISPATCH_CHANNEL_TWEET, type DiffEntry, type DiffResult, type DispatchAudienceContext, type DispatchBrandContext, type DispatchChannel, type DispatchRun, type ExportFormat, FORGE_AUDIENCES, FORGE_BRAND_THEME_ID, FORGE_TEMPLATES, FREE_TIER_WIDGET_IDS, type FileEntry, type ForgeAsset, type ForgeAudience, type ForgeGenerationDryRun, type ForgeGenerationError, type ForgeGenerationGenerated, type ForgeGenerationInput, type ForgeGenerationResult, type ForgeOutput, type ForgePrompt, type ForgeScope, type ForgeSignal, type ForgeStorage, type ForgeSubview, type ForgeTemplate, type ForgeThemeEntry, type FormErrors, type FormField, type FormSpec, type FormSpecOk, type FormSpecRaw, type Format, type GenerateADROpts, type GenerateApiChangelogOpts, type GenerateChangeImpactBriefOpts, type GenerateComplianceDocOpts, type GenerateNewsletterOpts, type GeneratePresentationOpts, type GenerateRoiSlideOpts, type GenerateSprintRetroOpts, type GenerationResult, type GitRangeContext$1 as GitRangeContext, type GreenInsightContext, type GreenLayerContext, type Intent, type KnowledgeCaptureOptions, type KnowledgeCaptureResult, type KnowledgeCaptureSection, type ListOutputsOpts, type LlmMessage, type LlmProvider, type LlmRequest, type LlmResponse, MAX_ANIMATION_DURATION_SECONDS, MIN_ANIMATION_DURATION_SECONDS, type Modality, type NewsletterOutput, type NumberField, type ObjectField, type OnboardingDocOpts, type OrchestrationInput, type OrchestrationResult, type OutputStatus, PRISM_TEMPLATES, PRISM_TEMPLATE_ARCHITECTURE_OVERVIEW, PRISM_TEMPLATE_REFACTOR_RATIONALE, PRISM_TEMPLATE_RELEASE_ANNOUNCEMENT, PRISM_TEMPLATE_SHIPPING_DIGEST, PRISM_TEMPLATE_ZONE_DEEPDIVE, type PresentationOutput, type PresentationSlide, type PresentationSlideType, type PrismBrandDraft, type PrismContextPrompt, type PrismData, type PrismFocus, type PrismInsight, type PrismRecommendation, type PrismSession, type PrismTemplate, type ProductTruth, type ProductTruthClaim, REFINE_COUNTDOWN_THRESHOLD, REFINE_SESSION_SOFT_CAP, REFINE_SUGGESTIONS, type RadioOptions, type RadioResult, type ReadingLevel, type RefactoringReportOpts, type RefineAssetInput, type RefineAssetResult, type RefineLimitState, type RefineSuggestion, type ReleaseNotesOpts, type RenderWidgetInput, type ResolveBrandPaletteInput, type ResolvedTuple, type RoiBreakdownItem, type RoiEstimate, type RoiSlide, type RoiSlideOutput, type RoiSlideType, STYLE_PRESET_BRUTALIST, STYLE_PRESET_DEFAULT, STYLE_PRESET_GLASSY, STYLE_PRESET_MINIMAL, type ScheduleRange, type ScheduledEntry, type ScheduledEntryMetadata, type ScheduledStatus, type SchemaDefinitionErr, type SchemaDefinitionOk, type SchemaDefinitionResult, type ScopeKind, type SignalKind, type SprintRetroOutput, type StringField, type StyleTokens, TEMPLATE_SCHEMA_EXAMPLES, TEMPLATE_SCHEMA_GENERIC, type TokenUsage, type Tonality, type UrlBrandHints, type ValidationErr, type ValidationOk, type ValidationResult, WIDGET_TEMPLATE_CHANGELOG_ROW, WIDGET_TEMPLATE_CTA_BANNER, WIDGET_TEMPLATE_FEATURE_GRID, WIDGET_TEMPLATE_METRIC_BADGE, WIDGET_TEMPLATE_PRICING_TIER, WIDGET_TEMPLATE_SOCIAL_PROOF, WIDGET_TEMPLATE_STAT_CARD, WIDGET_TEMPLATE_TESTIMONIAL, type WeeklyDigestContext, type WidgetExportFormat, type WidgetInstance, type WidgetInstanceSnapshot, type WidgetKind, type WidgetSlotDef, type WidgetSlotType, type WidgetStyle, type WidgetStyleSnapshot, type WidgetTemplate, type Zone, applyEntryPatch, asAudienceId, assembleBrandUrlExtractionPrompt, assembleForgePrompt, brandThemeConfigToEntry, buildPrismContextPrompt, buildRevertVersion, buildScheduledEntry, buildVersion, cascadingScheduledFor, clampAnimationDuration, computeDiff, defaultBrandKit, defaultValueForField, deriveContextSummary, distill, entryInRange, exportToBufferCsv, exportToHypefuryCsv, exportToICalendar, extractBrandFromPrismBlueprint, extractDependencyHotspots, extractTopChurnFiles, extractZones, generateADR, generateApiChangelog, generateArc42, generateArchitectureWalkthrough, generateAskDrivenAsset, generateChangeImpactBrief, generateChangesSince, generateComplianceDoc, generateKnowledgeCapture, generateNewsletter, generateOnboardingDoc, generatePresentation, generateRadio, generateRefactoringReport, generateReleaseNotes, generateRoiSlide, generateSprintRetro, getDispatchChannel, getPrismTemplate, getSlotValue, getStyleById, getWidgetTemplate, initialFormValues, next7DaysRange, nextVersionNumber, normalizePrismlensBlueprint, orchestrateDispatch, parseAndValidateSchemaDefinition, parseBrandKitFromLlmResponse, parseBrandThemeContent, parseStyleFromCss, parseStyleFromTailwindConfig, parseStyleFromTokensJson, parseThemeConfigContent, previewExport, readAmberLayer, readBlueprintData, readBlueprintFromTarget, readGreenLayer, readPrismDirectory, refineAsset, refineLimitState, renderWidget, resolveAnimatedChoice, resolveAnimationDuration, resolveBrandPalette, runForgeGeneration, scanForSecrets, schemaExampleFor, schemaToForm, templateAnimatedDefault, themeEntryToPalette, tryParseJsonObject, validateAgainstTemplateSchema, validateAssetSlots, validateFormValues, validateSchemaDefinition };