forgesmith 0.7.0 → 0.7.1

package/dist/server.d.cts

@@ -584,7 +584,7 @@ interface ADROutput {
 }
 declare function generateADR(opts: GenerateADROpts): Promise<ADROutput>;
 
-interface GitRangeContext {
+interface GitRangeContext$1 {
     commits: Array<{
         hash: string;
         subject: string;
@@ -597,7 +597,7 @@ interface GitRangeContext {
     filesChanged: number;
 }
 interface GenerateSprintRetroOpts {
-    gitContext?: GitRangeContext;
+    gitContext?: GitRangeContext$1;
     amberContext?: AmberLayerContext;
     greenContext?: GreenLayerContext;
     scoreBefore?: number;
@@ -777,6 +777,207 @@ interface KnowledgeCaptureResult {
 }
 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";
 /** "html" = embeddable fragment (no CDN scripts).
@@ -1384,4 +1585,4 @@ 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 };
+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 };

package/dist/server.d.ts

@@ -584,7 +584,7 @@ interface ADROutput {
 }
 declare function generateADR(opts: GenerateADROpts): Promise<ADROutput>;
 
-interface GitRangeContext {
+interface GitRangeContext$1 {
     commits: Array<{
         hash: string;
         subject: string;
@@ -597,7 +597,7 @@ interface GitRangeContext {
     filesChanged: number;
 }
 interface GenerateSprintRetroOpts {
-    gitContext?: GitRangeContext;
+    gitContext?: GitRangeContext$1;
     amberContext?: AmberLayerContext;
     greenContext?: GreenLayerContext;
     scoreBefore?: number;
@@ -777,6 +777,207 @@ interface KnowledgeCaptureResult {
 }
 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";
 /** "html" = embeddable fragment (no CDN scripts).
@@ -1384,4 +1585,4 @@ 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 };
+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 };