forgesmith 0.6.0 → 0.7.0

package/dist/server.d.cts

@@ -0,0 +1,1387 @@
+interface PrismSession {
+    id: string;
+    title: string;
+    summary?: string;
+    conclusion?: string;
+    createdAt?: string;
+}
+interface PrismRecommendation {
+    id: string;
+    title: string;
+    severity?: "low" | "medium" | "high" | "critical";
+    accepted?: boolean;
+    description?: string;
+}
+interface PrismInsight {
+    id: string;
+    title: string;
+    body?: string;
+}
+interface PrismData {
+    sessions?: PrismSession[];
+    recommendations?: PrismRecommendation[];
+    insights?: PrismInsight[];
+    fromDate?: string;
+    toDate?: string;
+}
+interface ReleaseNotesOpts {
+    tone?: "professional" | "casual" | "technical" | "executive";
+    length?: "short" | "medium" | "long";
+    format?: "markdown" | "plain";
+}
+interface BlueprintFile {
+    path: string;
+    category?: "app" | "component" | "lib" | "hook" | string;
+    importCount?: number;
+    importedByCount?: number;
+    lineCount?: number;
+}
+interface BlueprintEdge {
+    from: string;
+    to: string;
+    type?: string;
+}
+interface BlueprintData {
+    targetPath: string;
+    scanTimestamp: number;
+    stats: {
+        totalFiles: number;
+        runtimeEdges: number;
+        [key: string]: number;
+    };
+    files: BlueprintFile[];
+    edges: BlueprintEdge[];
+    categories: {
+        app: number;
+        component: number;
+        lib: number;
+        hook: number;
+        [key: string]: number;
+    };
+}
+interface ArchitectureWalkthroughOpts {
+    tone?: "professional" | "casual" | "technical" | "executive";
+    length?: "short" | "medium" | "long";
+    format?: "markdown" | "plain";
+}
+interface ChangesSinceOpts {
+    tone?: "professional" | "casual" | "technical";
+    length?: "short" | "medium" | "long";
+    format?: "markdown" | "plain";
+}
+interface OnboardingDocOpts {
+    tone?: "professional" | "casual" | "technical" | "executive";
+    length?: "short" | "medium" | "long";
+    format?: "markdown" | "plain";
+}
+interface RefactoringReportOpts {
+    tone?: "professional" | "casual" | "technical" | "executive";
+    length?: "short" | "medium" | "long";
+    format?: "markdown" | "plain";
+}
+type AskDrivenAssetFormat = "markdown" | "blog" | "social" | "email" | "slack" | "slide";
+interface AskDrivenAssetOpts {
+    format?: AskDrivenAssetFormat;
+    tone?: "professional" | "casual" | "technical" | "executive";
+    length?: "short" | "medium" | "long";
+}
+interface GenerationResult {
+    text: string;
+    metadata: {
+        generatedAt: string;
+        usedTokens: number;
+        generator: "forgesmith";
+    };
+}
+
+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";
+type AudienceId = string & {
+    readonly __brand: "AudienceId";
+};
+declare const asAudienceId: (id: string) => AudienceId;
+type Intent = "inform" | "pitch" | "announce" | "convince" | "educate" | "explain_to_layperson" | "recruit" | "celebrate_release";
+type Format = "long_article" | "short_post" | "carousel_sequence" | "story_sequence" | "pitch_paragraphs" | "landing_block" | "one_pager_section" | "quote_card" | "screenshot_narrative" | "visual_brief" | "video_brief" | "shotlist" | "hook_sequence";
+type Modality = "text" | "text_with_visual_brief" | "interactive_visual" | "image" | "video" | "mixed";
+type AssetKind = "image_brief" | "screenshot_request" | "video_brief" | "shotlist" | "quote_card_spec";
+type OutputStatus = "draft" | "generating" | "ready" | "failed";
+type Tonality = "sachlich-tief" | "sachlich-zugänglich" | "ambitioniert-glaubwürdig" | "warm-zugänglich" | "nüchtern-direkt";
+type ReadingLevel = "expert" | "professional" | "general" | "lay";
+interface ForgeAudience {
+    id: AudienceId;
+    label: string;
+    tonality: Tonality;
+    reading_level: ReadingLevel;
+    channel_hints: Channel[];
+    description: string;
+}
+interface ForgeSignal {
+    id: string;
+    scope_kind: ScopeKind;
+    app_id?: string | null;
+    env?: string | null;
+    kind: SignalKind;
+    payload: Record<string, unknown>;
+    source_refs: Record<string, unknown>;
+    created_by?: string | null;
+    created_at: string;
+}
+interface ForgeTemplate {
+    id: string;
+    channel: Channel;
+    audience_id: AudienceId;
+    intent: Intent;
+    format: Format;
+    modality: Modality;
+    tonality?: Tonality;
+    schema_json: Record<string, unknown>;
+    asset_slots: Array<Record<string, unknown>>;
+    created_at?: string;
+}
+interface ForgeOutput {
+    id: string;
+    signal_id?: string | null;
+    template_id?: string | null;
+    status: OutputStatus;
+    scope_kind: ScopeKind;
+    app_id?: string | null;
+    env?: string | null;
+    channel: Channel;
+    audience_id: AudienceId;
+    intent: Intent;
+    format: Format;
+    modality: Modality;
+    result_json?: Record<string, unknown> | null;
+    revision_of?: string | null;
+    created_at: string;
+}
+interface ForgeAsset {
+    id: string;
+    output_id: string;
+    kind: AssetKind;
+    modality: Modality;
+    props_json: Record<string, unknown>;
+    source_refs: Record<string, unknown>;
+    widget_def_id?: string | null;
+    widget_runtime?: string | null;
+    widget_def_history?: Array<{
+        widget_def_id: string;
+        replaced_at: string;
+        reason?: string;
+    }>;
+    created_at: string;
+}
+interface ForgeScope {
+    kind: ScopeKind;
+    app_id?: string | null;
+    env?: string | null;
+}
+type ForgeSubview = "signals" | "templates" | "audiences" | "outputs" | "walkthroughs";
+interface Zone {
+    id: string;
+    name: string;
+    files: string[];
+    fileCount: number;
+    heat: number;
+}
+interface FileEntry {
+    path: string;
+    importCount: number;
+    importedByCount: number;
+    lineCount: number;
+    zone: string;
+}
+
+/** Defence-in-depth: scan derived text for secret patterns before sending to LLM. */
+declare function scanForSecrets(text: string): boolean;
+
+/**
+ * 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;
+
+/** Groups files into zones (top-level directory segments). Sorted by heat desc. */
+declare function extractZones(blueprint: BlueprintData): Zone[];
+/** Files with highest importedByCount — proxy for "most-changed / hottest" files. */
+declare function extractTopChurnFiles(blueprint: BlueprintData, n?: number): FileEntry[];
+/** Files with highest importCount — most dependency-heavy, highest coupling. */
+declare function extractDependencyHotspots(blueprint: BlueprintData, n?: number): FileEntry[];
+
+/**
+ * Produces a compact LLM-ready summary of the blueprint.
+ * Contains ONLY metrics, file paths, and category names — never raw file contents.
+ * Scanned for secrets before return; throws if any found (should never happen).
+ */
+declare function deriveContextSummary(blueprint: BlueprintData): string;
+
+interface BrandKitPalette {
+    primary: string;
+    secondary: string;
+    accent: string;
+    surface: string;
+    text: string;
+    muted: string;
+}
+interface BrandKitFonts {
+    heading: string;
+    body: string;
+    mono: string;
+}
+interface BrandKitVoice {
+    tone: string;
+    audience: string;
+    vocabulary: string[];
+    avoid: string[];
+    formality: number;
+    technicality: number;
+}
+interface BrandKitLogo {
+    url?: string;
+    svg?: string;
+}
+interface BrandKitSnapshot {
+    version: number;
+    saved_at: string;
+    palette: BrandKitPalette;
+    voice: BrandKitVoice;
+}
+interface BrandKit {
+    id: string;
+    name: string;
+    source: "manual" | "url" | "prism";
+    source_url?: string;
+    palette: BrandKitPalette;
+    fonts: BrandKitFonts;
+    voice: BrandKitVoice;
+    logo: BrandKitLogo;
+    prism_detected?: boolean;
+    version: number;
+    versions: BrandKitSnapshot[];
+    created_at: string;
+    updated_at: string;
+}
+declare const DEFAULT_BRAND_KIT_PALETTE: BrandKitPalette;
+declare const DEFAULT_BRAND_KIT_FONTS: BrandKitFonts;
+declare const DEFAULT_BRAND_KIT_VOICE: BrandKitVoice;
+declare function defaultBrandKit(partial?: Partial<BrandKit>): Omit<BrandKit, "id" | "created_at" | "updated_at">;
+interface UrlBrandHints {
+    url: string;
+    pageTitle?: string;
+    metaDescription?: string;
+    themeColor?: string;
+    ogImage?: string;
+    cssColorHints?: string[];
+    fontHints?: string[];
+}
+declare function assembleBrandUrlExtractionPrompt(hints: UrlBrandHints): string;
+declare function parseBrandKitFromLlmResponse(text: string, hints: UrlBrandHints): Omit<BrandKit, "id" | "created_at" | "updated_at" | "version" | "versions">;
+interface PrismBrandDraft {
+    suggestedName: string;
+    voice: BrandKitVoice;
+    prism_detected: true;
+    blueprint_path: string;
+    stats: {
+        totalFiles: number;
+        categories: Record<string, number>;
+        technicalScore: number;
+        audienceMix: string;
+    };
+}
+
+declare function extractBrandFromPrismBlueprint(targetPath: string): Promise<PrismBrandDraft>;
+
+type PrismFocus = "release" | "changelog" | "deepdive" | "summary" | `zone:${string}` | `module:${string}`;
+interface PrismContextPrompt {
+    systemFragment: string;
+    contextBlock: string;
+    suggestedAsk: string;
+}
+interface PrismTemplate {
+    id: string;
+    name: string;
+    description: string;
+    defaultFocus: PrismFocus;
+    suggestedAsk: string;
+    suggestedChannels: string[];
+    requiresZone?: boolean;
+}
+declare const PRISM_TEMPLATE_RELEASE_ANNOUNCEMENT: PrismTemplate;
+declare const PRISM_TEMPLATE_SHIPPING_DIGEST: PrismTemplate;
+declare const PRISM_TEMPLATE_ZONE_DEEPDIVE: PrismTemplate;
+declare const PRISM_TEMPLATE_ARCHITECTURE_OVERVIEW: PrismTemplate;
+declare const PRISM_TEMPLATE_REFACTOR_RATIONALE: PrismTemplate;
+declare const PRISM_TEMPLATES: PrismTemplate[];
+declare function getPrismTemplate(id: string): PrismTemplate | undefined;
+
+declare function buildPrismContextPrompt(blueprint: BlueprintData, focus?: PrismFocus, highlight?: string): PrismContextPrompt;
+
+interface LlmMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+interface LlmRequest {
+    model?: string;
+    messages: LlmMessage[];
+    maxTokens?: number;
+    systemPrompt?: string;
+}
+interface LlmResponse {
+    content: string;
+    usedTokens: number;
+}
+interface LlmProvider {
+    complete(request: LlmRequest): Promise<LlmResponse>;
+}
+
+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, 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, amberContext?: AmberLayerContext, greenContext?: GreenLayerContext): Promise<GenerationResult>;
+
+declare function generateAskDrivenAsset(blueprint: BlueprintData | null, question: string, opts: AskDrivenAssetOpts, provider: LlmProvider): Promise<GenerationResult>;
+
+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 {
+    commits: Array<{
+        hash: string;
+        subject: string;
+        author?: string;
+        date?: string;
+        files?: string[];
+    }>;
+    fromRef: string;
+    toRef: string;
+    filesChanged: number;
+}
+interface GenerateSprintRetroOpts {
+    gitContext?: GitRangeContext;
+    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>;
+
+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";
+/** "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;
+    type: WidgetSlotType;
+    default?: string | number;
+    required?: boolean;
+    placeholder?: string;
+    options?: string[];
+}
+interface WidgetTemplate {
+    id: WidgetKind;
+    name: string;
+    description: string;
+    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;
+    saved_at: string;
+    slots: Record<string, string | number>;
+    style_id?: string;
+}
+interface WidgetInstance {
+    id: string;
+    template_id: WidgetKind;
+    name: string;
+    slots: Record<string, string | number>;
+    brand_kit_id?: string;
+    style_id?: string;
+    version: number;
+    versions: WidgetInstanceSnapshot[];
+    created_at: string;
+    updated_at: string;
+}
+declare function getSlotValue(slots: Record<string, string | number>, template: WidgetTemplate, slotId: string): string;
+
+interface StyleTokens {
+    radius: {
+        sm: string;
+        md: string;
+        lg: string;
+        full: string;
+    };
+    shadow: {
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+    borderWidth: string;
+    borderStyle: "solid" | "dashed" | "none";
+    animation: {
+        entry: "fade" | "slide" | "scale" | "none";
+        durationMs: number;
+    };
+}
+interface WidgetStyleSnapshot {
+    version: number;
+    saved_at: string;
+    tokens: StyleTokens;
+}
+interface WidgetStyle {
+    id: string;
+    name: string;
+    preset: boolean;
+    tokens: StyleTokens;
+    customCss?: string;
+    templateOverrides?: Record<string, {
+        html?: string;
+        jsx?: string;
+    }>;
+    version: number;
+    versions: WidgetStyleSnapshot[];
+    created_at: string;
+    updated_at: string;
+}
+declare const STYLE_PRESET_DEFAULT: WidgetStyle;
+declare const STYLE_PRESET_MINIMAL: WidgetStyle;
+declare const STYLE_PRESET_GLASSY: WidgetStyle;
+declare const STYLE_PRESET_BRUTALIST: WidgetStyle;
+declare const BUNDLED_STYLE_PRESETS: WidgetStyle[];
+declare function getStyleById(id: string): WidgetStyle;
+declare function parseStyleFromTokensJson(json: unknown): Partial<StyleTokens>;
+declare function parseStyleFromTailwindConfig(jsSource: string): Partial<StyleTokens>;
+declare function parseStyleFromCss(css: string): {
+    tokens: Partial<StyleTokens>;
+    customCss: string;
+};
+
+type ChannelKind = "tweet" | "linkedin" | "blog" | "newsletter" | "hn" | "instagram" | "reddit" | "email" | "slack";
+interface DispatchChannel {
+    id: string;
+    name: string;
+    kind: ChannelKind;
+    /** Hard character cap — orchestrateDispatch truncates to this. */
+    maxLength: number;
+    /** Injected into the channel-specific system prompt. */
+    promptHints: string;
+}
+declare const DISPATCH_CHANNEL_TWEET: DispatchChannel;
+declare const DISPATCH_CHANNEL_LINKEDIN: DispatchChannel;
+declare const DISPATCH_CHANNEL_BLOG: DispatchChannel;
+declare const DISPATCH_CHANNEL_NEWSLETTER: DispatchChannel;
+declare const DISPATCH_CHANNEL_HN: DispatchChannel;
+declare const DISPATCH_CHANNEL_INSTAGRAM: DispatchChannel;
+declare const DISPATCH_CHANNEL_REDDIT: DispatchChannel;
+declare const DISPATCH_CHANNEL_EMAIL: DispatchChannel;
+declare const DISPATCH_CHANNEL_SLACK: DispatchChannel;
+declare const BUNDLED_DISPATCH_CHANNELS: DispatchChannel[];
+declare function getDispatchChannel(id: string): DispatchChannel | undefined;
+
+interface ChannelOutput {
+    channel_id: string;
+    channel_name: string;
+    kind: string;
+    content: string;
+    char_count: number;
+    truncated: boolean;
+    generated_at: string;
+    error?: string;
+}
+interface DispatchRun {
+    id: string;
+    ask: string;
+    audience_label?: string;
+    brand_name?: string;
+    blueprint_grounded: boolean;
+    outputs: ChannelOutput[];
+    created_at: string;
+}
+interface DispatchBrandContext {
+    name: string;
+    voice: {
+        tone: string;
+        formality: number;
+        vocabulary?: string[];
+        avoid?: string[];
+    };
+}
+interface DispatchAudienceContext {
+    label: string;
+    tonality: string;
+    reading_level: string;
+}
+interface OrchestrationInput {
+    ask: string;
+    channels: DispatchChannel[];
+    audience?: DispatchAudienceContext;
+    brand?: DispatchBrandContext;
+    blueprintContext?: string;
+    toneOverrides?: Record<string, number>;
+}
+interface TokenUsage {
+    total_input: number;
+    total_output: number;
+    channel_count: number;
+}
+interface OrchestrationResult {
+    outputs: ChannelOutput[];
+    usage: TokenUsage;
+}
+declare function orchestrateDispatch(input: OrchestrationInput, provider: LlmProvider): Promise<OrchestrationResult>;
+
+interface AssetVersion {
+    id: string;
+    assetId: string;
+    versionNumber: number;
+    content: string;
+    message: string;
+    createdAt: string;
+    usedTokens?: number;
+    brandKitId?: string;
+    styleId?: string;
+    blueprintFocus?: string;
+    fromPrism?: boolean;
+    revertedFrom?: number;
+}
+interface DiffEntry {
+    type: "unchanged" | "added" | "removed";
+    line: string;
+    lineNo?: number;
+}
+interface DiffResult {
+    entries: DiffEntry[];
+    addedCount: number;
+    removedCount: number;
+}
+/**
+ * Deterministic line-level diff using a simple LCS approach.
+ * Returns DiffEntry[] suitable for a two-column diff display.
+ */
+declare function computeDiff(contentA: string, contentB: string): DiffResult;
+declare function buildVersion(assetId: string, versionNumber: number, content: string, message: string, meta?: Partial<Omit<AssetVersion, "id" | "assetId" | "versionNumber" | "content" | "message" | "createdAt">>): AssetVersion;
+declare function buildRevertVersion(assetId: string, versionNumber: number, source: AssetVersion): AssetVersion;
+declare function nextVersionNumber(versions: AssetVersion[]): number;
+
+type ScheduledStatus = "draft" | "queued" | "exported" | "cancelled";
+interface ScheduledEntryMetadata {
+    exportedTo?: "buffer" | "hypefury" | "icalendar";
+    exportedAt?: string;
+    exportRef?: string;
+    dispatchRunId?: string;
+    brandKitId?: string;
+    assetType?: string;
+}
+interface ScheduledEntry {
+    id: string;
+    assetId: string;
+    channelId: string;
+    scheduledFor: string;
+    status: ScheduledStatus;
+    contentPreview: string;
+    metadata: ScheduledEntryMetadata;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ScheduleRange {
+    from: string;
+    to: string;
+}
+declare function buildScheduledEntry(assetId: string, channelId: string, scheduledFor: string, contentPreview: string, metadata?: ScheduledEntryMetadata): ScheduledEntry;
+declare function applyEntryPatch(entry: ScheduledEntry, patch: Partial<Pick<ScheduledEntry, "scheduledFor" | "status" | "channelId" | "contentPreview" | "metadata">>): ScheduledEntry;
+declare function entryInRange(entry: ScheduledEntry, range: ScheduleRange): boolean;
+declare function next7DaysRange(): ScheduleRange;
+/** Cascading cadence for "Schedule all dispatch outputs". */
+declare function cascadingScheduledFor(channelIds: string[], startFrom?: Date): Record<string, string>;
+
+interface ListOutputsOpts {
+    signalId?: string;
+    templateId?: string;
+    limit?: number;
+}
+interface ForgeStorage {
+    getSignal(id: string): Promise<ForgeSignal | null>;
+    getTemplate(id: string): Promise<ForgeTemplate | null>;
+    getAudience(id: string): Promise<ForgeAudience | null>;
+    listTemplates(): Promise<ForgeTemplate[]>;
+    listAudiences(): Promise<ForgeAudience[]>;
+    listOutputs(opts?: ListOutputsOpts): Promise<ForgeOutput[]>;
+    saveSignal(signal: Omit<ForgeSignal, "id" | "created_at">): Promise<ForgeSignal>;
+    saveTemplate(template: Omit<ForgeTemplate, "created_at">): Promise<ForgeTemplate>;
+    saveAudience(audience: ForgeAudience): Promise<ForgeAudience>;
+    saveOutput(output: Omit<ForgeOutput, "id" | "created_at">): Promise<ForgeOutput>;
+    saveAsset(asset: Omit<ForgeAsset, "id" | "created_at">): Promise<ForgeAsset>;
+    deleteTemplate(id: string): Promise<void>;
+    deleteAudience(id: string): Promise<void>;
+    deleteOutput(id: string): Promise<void>;
+    saveBrandKit(kit: Omit<BrandKit, "id" | "created_at" | "updated_at"> & {
+        id?: string;
+    }): Promise<BrandKit>;
+    getBrandKit(id: string): Promise<BrandKit | null>;
+    listBrandKits(): Promise<BrandKit[]>;
+    deleteBrandKit(id: string): Promise<void>;
+    saveWidget(widget: Omit<WidgetInstance, "id" | "created_at" | "updated_at"> & {
+        id?: string;
+    }): Promise<WidgetInstance>;
+    getWidget(id: string): Promise<WidgetInstance | null>;
+    listWidgets(templateId?: string): Promise<WidgetInstance[]>;
+    deleteWidget(id: string): Promise<void>;
+    saveStyle(style: Omit<WidgetStyle, "id" | "created_at" | "updated_at"> & {
+        id?: string;
+    }): Promise<WidgetStyle>;
+    getStyle(id: string): Promise<WidgetStyle | null>;
+    listStyles(): Promise<WidgetStyle[]>;
+    deleteStyle(id: string): Promise<void>;
+    saveDispatch(run: Omit<DispatchRun, "id" | "created_at"> & {
+        id?: string;
+    }): Promise<DispatchRun>;
+    getDispatch(id: string): Promise<DispatchRun | null>;
+    listDispatches(limit?: number): Promise<DispatchRun[]>;
+    deleteDispatch(id: string): Promise<void>;
+    saveAssetVersion(assetId: string, version: AssetVersion): Promise<AssetVersion>;
+    listAssetVersions(assetId: string): Promise<AssetVersion[]>;
+    revertAsset(assetId: string, versionId: string): Promise<AssetVersion>;
+    saveScheduledEntry(entry: ScheduledEntry): Promise<ScheduledEntry>;
+    listScheduledEntries(range?: ScheduleRange): Promise<ScheduledEntry[]>;
+    updateScheduledEntry(id: string, patch: Partial<Pick<ScheduledEntry, "scheduledFor" | "status" | "channelId" | "contentPreview" | "metadata">>): Promise<ScheduledEntry>;
+    deleteScheduledEntry(id: string): Promise<void>;
+}
+
+interface ProductTruthClaim {
+    id: string;
+    statement: string;
+    source_ref: string;
+}
+interface ProductTruth {
+    signal_id: string;
+    audience_id: string;
+    audience_label: string;
+    tonality: string;
+    reading_level: string;
+    claims: ProductTruthClaim[];
+    raw_source_refs: Record<string, unknown>;
+}
+declare function distill(input: {
+    signal: ForgeSignal;
+    audience: ForgeAudience;
+}): ProductTruth;
+
+interface ResolvedTuple {
+    channel: Channel;
+    audience_id: string;
+    intent: Intent;
+    format: Format;
+    modality: Modality;
+}
+interface ForgePrompt {
+    system: string;
+    user: string;
+    schema_name: string;
+    schema: unknown;
+}
+declare function assembleForgePrompt(input: {
+    template: ForgeTemplate;
+    audience: ForgeAudience;
+    productTruth: ProductTruth;
+    resolved: ResolvedTuple;
+    contextBlocks?: string[];
+}): ForgePrompt;
+
+interface ValidationOk<T> {
+    ok: true;
+    value: T;
+}
+interface ValidationErr {
+    ok: false;
+    errors: string[];
+    unsupported?: string[];
+}
+type ValidationResult<T = Record<string, unknown>> = ValidationOk<T> | ValidationErr;
+declare function validateAgainstTemplateSchema(schema: unknown, candidate: unknown): ValidationResult;
+declare function tryParseJsonObject(raw: string): unknown;
+
+interface SchemaDefinitionOk {
+    valid: true;
+}
+interface SchemaDefinitionErr {
+    valid: false;
+    errors: string[];
+}
+type SchemaDefinitionResult = SchemaDefinitionOk | SchemaDefinitionErr;
+declare function validateSchemaDefinition(input: unknown): SchemaDefinitionResult;
+declare function parseAndValidateSchemaDefinition(jsonText: string): {
+    valid: true;
+    parsed: Record<string, unknown>;
+} | {
+    valid: false;
+    errors: string[];
+};
+
+interface AssetSlotsValidationOk {
+    valid: true;
+}
+interface AssetSlotsValidationErr {
+    valid: false;
+    errors: string[];
+}
+type AssetSlotsValidationResult = AssetSlotsValidationOk | AssetSlotsValidationErr;
+declare function validateAssetSlots(input: unknown): AssetSlotsValidationResult;
+
+declare function templateAnimatedDefault(assetSlots: unknown): boolean;
+declare function resolveAnimatedChoice(templateDefault: boolean, override: boolean | undefined): boolean;
+
+declare const DEFAULT_ANIMATION_DURATION_SECONDS = 10;
+declare const ANIMATION_DURATION_PRESETS: readonly [5, 10, 20, 30];
+declare const MIN_ANIMATION_DURATION_SECONDS = 1;
+declare const MAX_ANIMATION_DURATION_SECONDS = 120;
+declare function clampAnimationDuration(seconds: number): number;
+declare function resolveAnimationDuration(override: number | undefined, persisted: number | undefined, fallback?: number): number;
+
+declare const REFINE_SESSION_SOFT_CAP = 100;
+declare const REFINE_COUNTDOWN_THRESHOLD = 90;
+interface RefineLimitState {
+    used: number;
+    capped: boolean;
+    remaining: number;
+    showCountdown: boolean;
+}
+declare function refineLimitState(usedRefines: number, softCap?: number): RefineLimitState;
+
+interface BrandPalette {
+    primary: string;
+    accent: string;
+    background: string;
+    card: string;
+    text: string;
+}
+interface ForgeThemeEntry {
+    id?: string;
+    label?: string;
+    primary?: string;
+    accent?: string;
+    bg?: string;
+    card?: string;
+    text?: string;
+    [key: string]: unknown;
+}
+declare function themeEntryToPalette(entry: ForgeThemeEntry | null | undefined): BrandPalette | null;
+declare function parseThemeConfigContent(content: unknown): ForgeThemeEntry[];
+declare const FORGE_BRAND_THEME_ID = "__forge_brand__";
+declare const BRAND_CONTENT_SLOT_KEYS: {
+    readonly primary: "content-primary";
+    readonly accent: "content-accent";
+    readonly bg: "content-bg";
+    readonly card: "content-card";
+    readonly text: "content-text";
+};
+interface BrandThemeConfig {
+    id?: string;
+    name?: string;
+    values?: Record<string, string>;
+    [key: string]: unknown;
+}
+declare function parseBrandThemeContent(content: unknown): BrandThemeConfig[];
+declare function brandThemeConfigToEntry(config: BrandThemeConfig | null | undefined): ForgeThemeEntry | null;
+interface ResolveBrandPaletteInput {
+    scope: ScopeKind;
+    themes: ForgeThemeEntry[];
+    selectedThemeId?: string | null;
+    frameworkDefault: BrandPalette | null;
+    appDefault: BrandPalette | null;
+}
+declare function resolveBrandPalette(input: ResolveBrandPaletteInput): BrandPalette | null;
+
+interface BaseField {
+    name: string;
+    label: string;
+    required: boolean;
+    description?: string;
+}
+interface StringField extends BaseField {
+    kind: "string";
+    multiline: boolean;
+    enum?: string[];
+    maxLength?: number;
+    minLength?: number;
+}
+interface NumberField extends BaseField {
+    kind: "number";
+    integer: boolean;
+    minimum?: number;
+    maximum?: number;
+}
+interface BooleanField extends BaseField {
+    kind: "boolean";
+}
+interface ArrayField extends BaseField {
+    kind: "array";
+    itemField: FormField | null;
+    minItems?: number;
+    maxItems?: number;
+}
+interface ObjectField extends BaseField {
+    kind: "object";
+    fields: FormField[];
+}
+type FormField = StringField | NumberField | BooleanField | ArrayField | ObjectField;
+interface FormSpecOk {
+    kind: "form";
+    fields: FormField[];
+}
+interface FormSpecRaw {
+    kind: "raw";
+    reason: string;
+}
+type FormSpec = FormSpecOk | FormSpecRaw;
+declare function schemaToForm(schema: unknown): FormSpec;
+declare function defaultValueForField(field: FormField): unknown;
+declare function initialFormValues(fields: FormField[], source: Record<string, unknown>): Record<string, unknown>;
+type FormErrors = Record<string, string>;
+declare function validateFormValues(fields: FormField[], values: Record<string, unknown>): FormErrors;
+declare const TEMPLATE_SCHEMA_EXAMPLES: Partial<Record<Format, Record<string, unknown>>>;
+declare const TEMPLATE_SCHEMA_GENERIC: Record<string, unknown>;
+declare function schemaExampleFor(format: Format): Record<string, unknown>;
+
+interface ForgeGenerationInput {
+    /** Storage adapter the engine reads/writes through. */
+    storage: ForgeStorage;
+    /** LLM provider that handles the model call. */
+    provider: LlmProvider;
+    /** Signal id to generate from. */
+    signalId: string;
+    /** Template id that shapes the generation. */
+    templateId: string;
+    /** Per-generation tuple overrides — each replaces the template default. */
+    audienceOverride?: string;
+    intentOverride?: Intent;
+    formatOverride?: Format;
+    modalityOverride?: Modality;
+    /** Honest dry-run: assemble + validate inputs, never call the model, never persist. */
+    dryRun?: boolean;
+    /** Max tokens for the LLM call (default: 4096). */
+    maxTokens?: number;
+}
+interface ForgeGenerationError {
+    kind: "error";
+    status: number;
+    error: string;
+    field?: string;
+}
+interface ForgeGenerationDryRun {
+    kind: "dry_run";
+    payload: {
+        dryRun: true;
+        resolved: ResolvedTuple;
+        product_truth: unknown;
+        prompt: {
+            system: string;
+            user: string;
+            schema_name: string;
+        };
+    };
+}
+interface ForgeGenerationGenerated {
+    kind: "generated";
+    status: 200 | 201;
+    payload: {
+        output: unknown;
+        validation: ReturnType<typeof validateAgainstTemplateSchema> | null;
+        failure_reason: string | null;
+    };
+}
+type ForgeGenerationResult = ForgeGenerationError | ForgeGenerationDryRun | ForgeGenerationGenerated;
+declare function runForgeGeneration(input: ForgeGenerationInput): Promise<ForgeGenerationResult>;
+
+declare const WIDGET_TEMPLATE_STAT_CARD: WidgetTemplate;
+declare const WIDGET_TEMPLATE_FEATURE_GRID: WidgetTemplate;
+declare const WIDGET_TEMPLATE_TESTIMONIAL: WidgetTemplate;
+declare const WIDGET_TEMPLATE_CTA_BANNER: WidgetTemplate;
+declare const WIDGET_TEMPLATE_METRIC_BADGE: WidgetTemplate;
+declare const WIDGET_TEMPLATE_PRICING_TIER: WidgetTemplate;
+declare const WIDGET_TEMPLATE_CHANGELOG_ROW: WidgetTemplate;
+declare const WIDGET_TEMPLATE_SOCIAL_PROOF: WidgetTemplate;
+declare const BUNDLED_WIDGET_TEMPLATES: WidgetTemplate[];
+declare const FREE_TIER_WIDGET_IDS: string[];
+declare function getWidgetTemplate(id: string): WidgetTemplate | undefined;
+
+interface RenderWidgetInput {
+    template: WidgetTemplate;
+    slots: Record<string, string | number>;
+    brandKit?: BrandKit | null;
+    style?: WidgetStyle | string | null;
+    format: WidgetExportFormat;
+}
+declare function renderWidget(input: RenderWidgetInput): string;
+
+declare const FORGE_AUDIENCES: ForgeAudience[];
+
+declare const FORGE_TEMPLATES: ForgeTemplate[];
+
+interface RefineAssetInput {
+    assetId: string;
+    assetType: string;
+    currentContent: string;
+    userMessage: string;
+    brandName?: string;
+    brandVoice?: string;
+    styleHint?: string;
+    blueprintContext?: string;
+}
+interface RefineAssetResult {
+    newContent: string;
+    llmReply: string;
+    usedTokens: number;
+}
+/**
+ * Sends the current asset content + user message to an LLM and returns
+ * the refined content and a brief explanation of changes.
+ *
+ * Applies scanForSecrets() to both the system prompt and the current content
+ * before sending — throws if secrets are detected (defence-in-depth).
+ */
+declare function refineAsset(input: RefineAssetInput, provider: LlmProvider): Promise<RefineAssetResult>;
+declare const REFINE_SUGGESTIONS: readonly ["Make it more concise", "Add more technical detail", "Make the tone more formal", "Make the tone more casual and conversational", "Add a strong opening hook", "Strengthen the call to action", "Break into shorter paragraphs", "Focus more on developer impact"];
+type RefineSuggestion = (typeof REFINE_SUGGESTIONS)[number];
+
+declare function exportToBufferCsv(entries: ScheduledEntry[]): string;
+declare function exportToHypefuryCsv(entries: ScheduledEntry[]): string;
+declare function exportToICalendar(entries: ScheduledEntry[]): string;
+type ExportFormat = "buffer" | "hypefury" | "icalendar";
+declare function previewExport(entries: ScheduledEntry[], format: ExportFormat): string;
+
+export { type ADRDocument, type ADROutput, ANIMATION_DURATION_PRESETS, type AdrContext, type AmberCapabilityContext, type AmberLayerContext, 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 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 GenerateComplianceDocOpts, type GenerateNewsletterOpts, type GeneratePresentationOpts, type GenerateSprintRetroOpts, type GenerationResult, type 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, 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, generateArc42, generateArchitectureWalkthrough, generateAskDrivenAsset, generateChangesSince, generateComplianceDoc, generateKnowledgeCapture, generateNewsletter, generateOnboardingDoc, generatePresentation, generateRadio, generateRefactoringReport, generateReleaseNotes, 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 };